(12) INTERNATIONAL APPLICATION PUBLISHED UNDER THE PATENT COOPERATION TREATY (PCT) 



(19) World Intellectual Property Organization 

International Bureau 

(43) International Publication Date 
22 March 2001 (22.03.2001) 




111 



PCT 



(10) International Publication Number 

WO 01/20484 A2 



(51) International Patent Classification 7 : G06F 17/00 

(21) International Application Number: PCT/USOQ/25305 

(22) International Filing Date: 

15 September 2000 (15.09.2000) 



(25) Filing Language: 

(26) Publication Language: 



English 
English 



(30) Priority Data: 

60/153,960 15 September 1999 (15.09.1999) US 

(71) Applicant: NETWORK SOLUTIONS, INC. [US/US]; 
505 Huntmar Park Drive, Hemdon, VA 20170 (US). 

(72) Inventors: CHAUHAN, Sanjeev; -. KORZENIEWSKI, 
Greg; NAKHRE, Sujata; -. TAYLOR, Brian; 
BREM, Larry; -. MOSTON, David; -. 

(74) Agents: GARRETT, Arthur, S. et aL; Finnegan, Hen- 
derson, Farabow, Garrett & Dunner, L.L.P., 1300 I Street, 
N.W., Washington, DC 20005-3315 (US). 



(81) Designated States (national): AB, AG, AL, AM, AT, AU, 
AZ, BA, BB, BG, BR, BY, BZ, CA, CH, CN, CR, CU, CZ, 
DE, DK, DM, DZ, EE, ES, FI, GB, GD, GE, GH, GM, HR, 
HU, ID, IL, IN, IS, JP, KE, KG, KP, KR, KZ, LC, LK, LR, 
LS, LT, LU, LV, MA, MD, MG, MK, MN, MW, MX, MZ, 
NO, NZ, PL, PT, RO, RU, SD, SE, SG, SI, SK, SL, TJ, TM, 
TR, TT, TZ, UA, UG, UZ, VN, YU, ZA, ZW. 

(84) Designated States (regional): ARIPO patent (GH, GM, 
KE, LS, MW, MZ, SD, SL, SZ, TZ, UG, ZW), Eurasian 
patent (AM, AZ, BY, KG, KZ, MD, RU, TJ, TM), European 
patent (AT, BE, CH, CY, DE, DK, ES, FT, FR, GB, GR, IE, 
IT, LU, MC, NL, PT, SE), OAPI patent (BF, BJ, CF, CG, 
CI, CM, GA, GN, GW, ML, MR, NE, SN, TD, TG). 

Published: 

— Without international search report and to be republished 
upon receipt of that report. 

For two-letter codes and other abbreviations, refer to the "Guid- 
ance Notes on Codes and Abbreviations" appearing at the begin- 
ning of each regular issue of the PCT Gazette. 



00 



© (54) Title: METHODS AND APPARATUS FOR ESTABLISHING AND MAINTAINING INERNET DOMAIN NAME REG IS - 
TRATIONS 



(57) Abstract: Methods and apparatus for conducting transactions associated with managing Internet domain names includes es- 
O tablishing a connection between application programs of other users and a registrar of Internet domain names over the Internet, 
^ authenticating the right of the user to so request fulfillment of a transaction, establishing a secure socket layer within the connection 
^ and processing commands after such authentication. 



WO 01/20484 



PCT/US00/25305 



METHODS AND APPARATUS FOR ESTABLISHING 
AND MAINTAINING INTERNET DOMAIN NAME 
REGISTRATIONS 



WO 01/20484 . ^ ^ PCT/US00/25305 

RELATED APPLICATION 

This applicarion claims the benefit of U.S. Provisional Application No. 60/153,960, filed 
September 15, 1999, the disclosure of which is expressly incorporated herein by reference. 
Copending U.S. Patent Application Serial No. 09/544,305, filed April 6, 2000, is also expressly 
incorporated herein by reference. 

FIELD OF THE INVENTION 

The present invention relates to the field of domain name registration. More particularly, 
the invention relates to methods and apparatus, which provides an application program interface to 
enable the registration and maintenance of Internet domain names. 

BACKGROUND OF THE INVENTION 

The explosive growth of the Internet has created the need for orderly management of the 
process for creating domain name registrations (also known as Web addresses) and subsequent 
administrative activities such as changes in ownership, renewals, and so forth. Until recently, 
Network Solutions, Inc. of Herndon, Virginia was the exclusive entity through which domain name 
registrations ("DNRs") were acquired and registered, at least for domain names ending in .com, 
.net, .org and .edu. In such role, Network Solutions, Inc. is known as a Registrar. Approximately 
five million Web addresses have been registered by Network Solutions, Inc. so far. 

Presently-implemented systems for registration of Web Addresses rely almost exclusively 
on the use of e-mails between users and the Registrar for each step of the process. For example, 
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FIG. 4 shows the sequence of steps for registration, a customer (Registrant) prepares to register 
new Web Address 100; 

The Registrant fills out a Service Agreement (102). The Service Agreement is submitted 
by e-mail to the Registrant, for example, to hostmaster@internic.net (step 104). The Request is 
automatically assigned a tracking number 106. The Service Agreement is automatically checked 
for errors 108. The Service Agreement is processed if there are no errors and the registrant is 
notified via e-mail when completed 1 12. Web Address registration is complete with a message. 
For example, the message may read: "Your Web Address registration is complete" (step 1 14). The 
customer is invoiced for the Web Address registration, step 116, and pays for the registration (step 
118). 

Finally, the Registrar sends a re-registration notice to registrant 60 days before the two year 
anniversary of the initial registration (step 120). Should there be an error in the Service 
Agreement, the registration process is not completed and an e-mail is sent to the customer 
informing it of the problem (step 110). 

While this process works effectively, it is not without certain shortcomings. Most notably, 
the use of the Internet for e-mailing notices is not generally on a "real-time" basis. It may 
sometimes take several days for an e-mail to be delivered, particularly to parts of the world where 
the Internet support structure is not fully established. In addition, e-mails may become corrupted 
which creates further delays since the recipient must ask for the messages to be resent. 

Further, recent events have resulted in the development of a concept termed "Wholesaling" 
by which other organizations, such as Internet Services Providers ("ISP"), Internet hosting 
providers, Internet portals and Electronic Commerce Providers are allowed to secure such DNRs 
on behalf of their own customers. In effect, such organizations act as their own Registrars by 
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offering their customers an interface which permits unsophisticated and sophisticated users to 
interface with the registration process and subsequent management thereof. Ultimately, however, 
DNRs are still issued by the Registrar, Network Solutions, Inc. 

This expansion in the number of outlets for securing DNRs has led to the development of 
systems and methods to facilitate wholesaling. 

Network Solutions, Inc. provides the NSI Wholesale Service Protocol ("WSP"), which 
establishes support of a real-time programmable interface for the purchase and management of 
Network Solutions, Inc. ("NSI") products and services a system. This system would permit users 
seeking registrations to complete the process, regardless of their level of expertise in computer 
technology in general, and the Internet in particular. The WSP uses a simple, connection-based, 
synchronized, ASCII text-based protocol to communicate with an NSI Wholesale System over the 
Internet, thereby allowing Wholesalers to securely and reliably create, modify, and delete customer 
accounts and various products including the registration and management of Internet domain 
names. 

The WSP consists of a set of commands that a Wholesaler may issue to create customers or 
domain-name-related products. Each command returns a set of 'properties' and major and minor 
error codes. In many cases, the result of one command is used as input to the next command. 

Wholesale commands are either synchronous or asynchronous. Generally, customer 
creation and management commands are synchronous, while domain creation and management 
commands are asynchronous. An "as-fast-as-possible" fulfillment system for asynchronous 
commands maintains queues in order to guarantee that the order is not lost in the case of external 
system problems. Typical synchronous response times are several seconds or less, while 
asynchronous times, for example, to complete a registration, are typically less than a few minutes. 
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There are two primary security mechanisms in the NSI Wholesale System. All 
Wholesalers must supply the IP addresses from which they will connect and establish Secure 
Socket Layer ("SSL") connections to the NSI Wholesale System. They also must use an account 
number and password when issuing session commands. NSI provides these ahead of time to 
Wholesalers. While this system provides numerous advantages over the prior art, there is a need to 
make the system universally available. 

Accordingly, there is presently a need for methods and apparatus which provides an 
application program interface to allow computer application programs of other users, to access the 
Wholesale system and to conduct transactions associated with the registration and management of 
Internet domain names in the same manner as the WSP. 

SUMMARY OF THE INVENTION 

To achieve these objects and other advantages and in accordance with the purposes of the 
invention, as embodied and broadly described herein. The present invention is directed to methods 
and apparatus for interfacing a user application program to a system for conducting transactions 
associated with managing Internet domain names by establishing over the Internet a connection 
between the user and the system; authenticating the right of the user to conduct a transaction 
associated with managing Internet domain names; establishing a secure socket layer within the 
application program interface and the system; receiving a request in the application program 
interface from the applications program to initiate a transaction following such authentication; and 
transmitting commands by the application program interface to the system effectuating the 
transaction. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

The accompanying drawings, which are incorporated in and constitute a part of this 
specification, illustrate an embodiment of the invention and together with the description, serve to 
explain the principles of the invention. In the drawings, 

FIG. 1 is a diagram of a preferred embodiment of the invention, wherein an application 
program interface, WSP Java API, implements the functionality of a WSP in a series of Java object 
classes; 

FIG. 2 shows an exemplary flowchart of the method for interfacing a user application 
program to a system for conducting transactions associated with managing Internet domain names; 

FIG. 3 shows an exemplary diagram of the apparatus for interfacing a user application 
program to a system for conducting transactions associated with managing Internet domain names. 

DETAILED DESCRIPTION 

Reference will now be made in detail to the present preferred embodiment of the invention, 
an example of which is illustrated in the accompanying drawings. Wherever possible, the same 
reference numbers will be used throughout the drawings to refer to the same or like elements. 

The methods and apparatus provides an application program interface that is accessed by 
user application programs to establish a connection to a system for conducting transactions 
associated with managing Internet domain names. 

Referring to FIG. 1, a computer application program 12 typically provides an interface to 
the user to collect customer data. The computer application program 12 typically issues a session 
request to the application program interface, WSP Java API 14, in order to establish a session over 
the Internet 10 with the Wholesale System 16 and to issue various commands. 
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The WSP Java API 14 is essentially a Java 'wrapper 1 of the WSP. It consists of two main 
classes: NSIWholesaleAPI and WSPResponse. The NSIWholesaleAPI contains all of the methods 
for creating customers, products, and services. WSPResponse is a single class returned from most 
methods and contains the result of the issued command request and will optionally include any 
additional data that was generated by the request. 

One advantage of using WSP Java API 14 is that when the NSIWholesaleAPI object is 
created, the object creates a 'pool 1 of SSL connections to the Wholesale system 16. This class 
removes the need to issue a 'session 1 command, and removes the burden from a Wholesaler of 
making and managing SSL connections. Multi-threaded applications may also use this connection 
pool. 

FIG. 2, shows an exemplary flowchart of the invention. A user 20, sends a request to the 
application program 12 to conduct a transaction associated with managing Internet domain names. 
The application program 12 typically provides an interface to a user to collect customer data. The 
application program 12 typically issues a session request to the application program interface 14 to 
establish a session over the Internet 10 with the Wholesale System 16. The application program 
interface 14 will authenticate a user's right to conduct a transaction by attempting to connect to the 
Wholesale System 16 using user account information received from the application program 12. If 
the authentication fails, the application program interface 14 will attempt two additional 
authentications. The application program interface 14 will send the result of the authentication to 
the application program 12. If the authentication is successful, the application program interface 
14 will establish a secure socket layer with the Wholesale System 16. The application program 12 
will send a request to the application program interface 14 to make available the set of commands 
through the instantiation of an object of class NSIWholesaleAPI. The application program 1 2 
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may now send a request to any of the object methods to request the processing of a command. The 
application program interface 14 will receive the command request along with any data. The 
application program interface 14 will format the data and the command into a string as described in 
detail in the aforementioned copending U.S. Patent Application Serial No. 09/544,305. The 
application program 14 will then transmit the request across the Internet 10 to the Wholesale 
System 16 to effectuate the transaction. The Wholesale System 16 will process the request and 
will return the result of the transaction across the Internet 10 to the application program interface 
14. The application program interface 14 will send a response to the application program 12. 

FIG. 3, is a diagram of an exemplary computer environment in which methods consistent 
with the present invention may be implemented. A component is provided for a user 20, to send a 
request to the application program 12 to conduct a transaction associated with managing Internet 
domain names. The application program 12 typically provides an interface to user 20 to collect 
customer data. The application program 12 typically issues a session request to the application 
program interface 14 to establish a session over the Internet 10 with the Wholesale System 16. A 
component is also provided for authenticating the right of the user 20 to conduct a transaction. The 
application program interface 14 will authenticate a user's right to conduct a transaction by 
attempting to connect to the Wholesale System 16 using the user account information received 
from the application program 12. If the authentication fails, the application program interface 14 
will attempt two additional authentications. The application program interface 14 will send the 
result of the authentication to the application program 12. A component is also provided for 
establishing a secure socket layer if the authentication is successful. The application program 
interface 14 will establish a secure socket layer with the Wholesale System 16. A component is 
also provided for initiating a transaction following a successful authentication. The application 
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program 12 will send a request to the application program interface 14 to make available the set of 
commands that are available in the Wholesale System 16 through the instantiation of an object of 
class NSI WholesaleAPI. The application program 12 may now send a request to any of the object 
methods to request the processing of a command. The application program interface 14 will 
receive the command request along with any data. A component is also provided for transmitting 
commands through the secure socket layer. The application program interface 14 will format the 
data and command into a string as described in detail in the aforementioned copending U.S. Patent 
Application Serial No. 09/544,305. The application program 14 will then transmit the request 
across the Internet 10 to the Wholesale System 16 to effectuate the transaction. The Wholesale 
System 16 will process the request and return the result of the transaction across the Internet 10 to 
the application program interface 14. The application program interface 14 will send a response to 
the application program 12. 

The name of the WSP Java API configuration file is typically WSP j avaAPI . conf . This 
file contains specific information about each Wholesale user. The values for the-parameters in that 
file are provided when a Wholesale agreement is completed with a Registrar, such as NSL The file 
includes the following parameters: 

WholesaleAPI ,minConnections=2 ~ 
WholesaleAPI .maxConnections=2 
WholesaleAPI .coimectionSoTimeout=120000 
WholesaleAPI . connect ionProtocol=WSPl . 5 
WholesaleAPI . server=XXX.ne tsol .com 
WholesaleAPI .port =X000 
WholesaleAPI . retry=l 

WholesaleAPI . WholesalerAccountId=1234557S 
WholesaleAPI . WholesalerPassword=XXXXXXXX 
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The values indicated with an "X" will change from user to user. The definition of each of 
these parameters is as follows: 



Configuration File Parameters 



Name 


Type 


Typical Value 


Definition 


minConnections 


Positive 
Integer 


2 through 10 


Connection Pooling Tuning Parameter 


maxConnections 


Positive 
Integer 


minConnections 
through 5 


Connection Pooling Tuning Parameter 


connectionSoTimeout 


Positive 
Integer 


120000 


Number of milliseconds of non-use 
before the API will time out a 
connection 


Server 


String 


X.netsol.com 


Server name for Wholesale protocol at 
Registrar. The exact name will be 
provided when the Wholesale agreement 
is established. 


Port 


Integer 


XXXX 


IP Port on the server for connection 


WholesalerAccountld 


String 


XXX 


Unique identifier of each Wholesale 
partner 


WholesalerPassword 


String 


xxxxxxx 


Unique code, necessary for connection 
to NSI, for Wholesale operations 



CLASS HIERARCHY 
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o class iava.lang. Obiect 

o class nsi.wholesale.toolkit.iavaapi. NSIWholesalcAPI 
o class iava.lang. Throwab!e (implements iava.io. Serializable) 
o class iava.lang. Exception 

o class nsi^wholesale.toolkit.iavaapi. NSIWholesaleException 
o class nsi.wholesale.toolkit.iavaapi. WSPException 

o class nsi.wholesale.toolkitiavaapi JnvalidArgumentExceDtion 
o class nsi.wholesale^toolkitjavaapi JnvalidResponseFormatException 
o class nsi.wholesale.toolkit.iavaapi. WSPResponse 



The NSIWholesaleAPI class constructs an instance of a new NSIWholesaleAPI object 
whose methods can be called to perform Wholesale-related activities, such as connecting to the 
Wholesale System 16 over the Internet through a SSL, and it allows the computer application 
program 12 to create and manage Internet domain names. The class definition for 
NSIWholesaleAPI includes the following: 



Constructor Summary 


NSIWholesaleAPI ( ) 


Method Summary 


WSPResponse 


createBusinessAccount (String aCompanyName , 




String aCompanyType , String aAddressl, String aCitv, 

String a Country Code , String aPhone, String aCustomerPassword, 

String aAuthQuestion, String aAuthAnswer, 

String aLegalContactFirstName, String aLegalContactLastName) 

This method creates a business customer account and returns 
an automatically generated customer account id. 


WSPResponse 


createBusinessAccount (String aCompanyName, 




String aCompanyType, String aAddressl, String aCity, 

String aCountryCode, String aPhone, String aCustomerPassword, 



-11- 
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Strinq aAuthQuestion, String aAuthAnswer, 

Strinq aLeqalContactFirstName, String aLeqalContactLastNamp 
Properties optionalAttributes) 

This method creates a business customer account and returns 
an automatically generated customer account id. 


WSPResponse 


createBusinessAccount (String aCompanyName , 




Strinq aCompanyType, Strinq aAddressl, Strinq aCitv, 

Strinq aCountryCode, Strinq aPhone, Strinq aCustomerPassword 

Strinq aAuthQuestion, Strinq aAuthAnswer, 

Strinq aLeqalContactFirstName, Strinq aLeqalContactLastName, 
Strinq aState, Strinq aPostalCode) 

This method creates a business customer account and returns 
an automatically generated customer account id. 


WSPResponse 


createBusinessAccount (String aCompanyName, 




String aCompanyType, Strinq aAddressl, Strinq aCity, 

Strinq aCountryCode, Strinq aPhone, Strinq aCustomerPassword. 

String aAuthQuestion, String aAuthAnswer, 

Strinq aLeqalContactFirstName, Strinq aLeqalContactLastName r 
String aState, String aPostalCode, 
Properties optionalAttributes) 

This method creates a business customer account and returns 

an 2)1 itnmatipallv npnpratpH fNiQtnmpr arr*mint iri 

all dUlUM IdUl/aliy ^CIIdCHCU I^UOIUMICI aUUUUIIl tu. 


WSPResponse 


createDnsHosting (String pCustomerAccountld, 




String pCustomerPassword, String aDomainName) 

This method registers a DNS Hosting product for an existing 
customer account. 


WSPResponse 


createDnsHosting (String pCustomerAccountld, 




String pCustomerPassword, String aDomainName, 
Properties optionalAttributes) 

This method registers a DNS Hosting product for an existing 
customer account. 


WSPResponse 


createDomain (String pCustomerAccountld, 




String pCustomerPassword, String aDomainName, Strinq aHostldl, 
String aHostId2, Strinq aTechContactld) 

This method registers a new domain product for an existing 
customer account. 


WSPResponse 


createDomain (String pCustomerAccountld, 




Strinq pCustomerPassword, Strinq aDomainName, Strinq aHostldl, 
Strinq aHostId2, Strinq aTechContactld, 
Properties optionalAttributes) 

This method registers a new domain product for an existing 
customer account. 


WSPResponse 


createDomain (String pCustomerAccountld, 




String pCustomerPassword, String aDomainName, 

Strinq aHostNamel, String aHostAddrl, String aHostName2, 

String aHostAddr2, String aTechContactld) ' 

This method registers a new domain product for an existing 
customer account. 
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WSPResponse 


createDomain (String pCustomer Account Id, 




String pCustomerPas sword, String aDomainName, 

String aHostNamel, String aHostAddrl, String aHostName2 

String aHostAddr2, String aTechContactld, 

Properties oDtionalAttributes) 

This method registers a new domain product for an existing 
customer account. 


WSPResponse 


createlndividualAccount (String aFirstName, String aLastName 




String aAddressl, String aCountryCode, String aPhone. 
String aCustomerPassword, String aAuthQuestion, 
String aAuthAnswer, String aCity) 

| This method creates an individual customer account and returns 
an automatically generated customer account id. 


WSPResponse 


createlndividualAccount (String aFirstName, String aLastName, 




String aAddressl, String aCountryCode, String aPhone, 
String aCustomerPassword, String aAuthQuestion, 
String aAuthAnswer, String aCity, 
Properties optionalAttributes) 

This method creates an individual customer account and returns 
an automatically generated customer account id. 


WSPResponse 


createlndividualAccount (String aFirstName, String aLastName, 




String aAddressl, String aCountryCode, String aPhone, 
String aCustomerPassword, String aAuthQuestion. 
String aAuthAnswer, String aCity, String aState, 
String aPostalCode) 

This method creates an individual customer account and returns 
an automatically generated customer account id. 


WSPResponse 


createlndividualAccount (String aFirstName, String aLastName, 




String aAddressl, String aCountryCode, String aPhone, 
String aCustomerPassword, String aAuthQuestion, 
String aAuthAnswer, String aCity, String aState, 
String aPostalCode, Properties optionalAttributes) 

This method creates an individual customer account and returns 
an automatically generated customer account id. 


WSPResponse 


createTechnicalContact (String aFirstName, String aLastName, 




String aOrganization, String aAddressl, String aCountryCode, 
String aPhone, String aEmail, String aTechContactPassword. 
String aCity) 

This method creates a technical contact and returns an 
automatically generated technical contact id (NIC Handle). 


WSPResponse 


createTechnicalContact (String aFirstName, String aLastName, 




String aOrganization, String aAddressl, String aCountryCode, 
String aPhone, String aEmail, String aTechContactPassword. 
String aCity, Properties optionalAttributes) 

\ nib meinou creaies a lecnmcai coniaci anu returns an 
automatically generated technical contact id (NIC Handle). 


WSPResponse 


createTechnicalContact (String aFirstName, String aLastName, 




String aOrganization, String aAddressl, String aCountryCode, 
String aPhone, String aEmail, -String aTechContactPassword, 
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Strinq aCity, String aState, Strinq aPostalCode) 

This method creates a technical contact and returns an 
automatically generated technical contact id (NIC Handle). 


WSPResponse 


createTechnicalContact (String aFirstName, Strinq aLastName 




Strinq aOrqanization, String aAddressl, Strinq aCountrvCode 
Strinq aPhone, String aEmail, Strinq aTechContact Password 
Strinq aCity, Strinq aState, Strinq aPostalCode, 
Properties optionalAttributes) 

i nis rneinou creates a lecnnicai contact ano returns an 
automatically generated technical contact id (NIC Handle). 


wo f Response 


aescriDe \ocrmg pTarget) 

This method provides information about a specified target. 


WSPResponse 


describe (Strinq oTaraet. Prooerties oDtionalAi-t-rihnhpq^ 




1 nis metnoa proviaes information about a specified target. 


WSPResponse 


genera teDomainName (Strinq pKeyWords ) 




This method is used to generate a list of available domain 
names uasea on a specmeo list or Keyworos. 


WSPResponse 


generateDomainName (Strinq pKeyWords , 




Properties optionalAttributes) 

This method is used to generate a list of available domain 
names based on a specified list of keywords. 


static Strinq 


getJdkVersion ( ) 

Static accessor method to get JDK version 


static long 


getSerialVersion ( ) 

Static accessor method to get serial version 


static double 


getVersion() 

Static accessor method to get release version 


WSPResponse 


help() 

This method returns ba^ifV information ahnnt the cunnnrfori 
protocol commands and classes. 


WSPResponse 
. — 


help (Properties ODtionalAt tributes ) 

This method returns basic information about the supported 
protocol commands and classes. 

- — ; — ; ; : — . ; ; 


static void 


init (Properties properties) 

Initializes the Wholesale Services Protocol API. 


static void 


initializes tne wnoiesaie cervices Protocol API; 


WSPResponse 


lookupBusiness Ac count ( ) 




Retrieves a list of all business customer accounts linked to 
wholesaler. 


WSPResponse 


lookupBusinessAccount (Properties optionalAttributes) ! 




Retrieves a list of all business customer accounts linked to 
wholesaler. 



- 14- 
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WSPResponse 


lookupBusinessAccount (Strinq pCus tome r Account Id. 




String pCus tome rPas sword) 

Retrieves details of a specific business customer account. 


WSPResponse 


lookupBusinessAccount (Strinq pCustomer Account Id. 




String pCustomerPassword, Properties optionalAttributes) 

RptriPX/P^ HptaMc nf a Qnppiflr* hiicinocc n icfnmor o^nnnt 
ixcuicvco uciallo Ul a ofJCulllL/ UUglllcoo CUStOmer dCCOUnt. 


WSPResponse 


lookupDnsHosting (Strinq pCustomer Account Id. 




String pCustomerPassword) 

Retrieves a list of all domain names associated with DNS 
Hostino Droducts owned bv ru^tompr 


WSPResponse 


lookupDnsHosting (Strinq pCustomerAccountld. 




String pCustomerPassword, Properties optionalAttributes). 

Retrieves a list of all domain names associated with DNS 

i iuoui iy pivjuuoio vWficu uy uuoiuilici. 


WSPResponse 


lookupDnsHosting (Strinq pCustomerAccountld. 




Strinq pCustomerPassword, Strinq pDomainName) 

Retrieves details of a specific DNS Hosting product owned by 
customer. 


WSPResponse 


lookupDnsHosting (Strinq pCustomerAccountld. 




String pCustomerPassword, String pDomainName. 
Properties optionalAt tributes) 

rvcuicvtjo ucLaiio ui a outrun iu L/iNo nosung prouuct owned DV 
customer. 


WSPResponse 


lookupDomain (Strinq pCustomerAccountld. 




Retrieves a list of all domain products owned by customer. 


WSPResponse 


lookupDomain (String pCustomerAccountld/ 




Strinq pCustomerPassword, Properties optionalAttributes) 

ixcuicvco a iioi ui cm uufiiaiii pruuucis owneo oy customer. 


WSPResponse 


lookupDomain (String pCustomerAccountld, 




String pCustomerPassword, Strinq pDomainName) 

Retrieves detail information about a specific domain product 
registered to a customer. 


WSPResponse 


lookupDomain (String pCustomerAccountld, 




Strinq pCustomerPassword, Strinq pDomainName, 
Properties optionalAttributes) 

Retrieves detail information about a specific domain product 

IcUlolclcU IU d UUolUiiltJi . 


WSPResponse 


lookupDomainByTechContact (String pCustomerAccountld. 




Strinq pTechContactld, String pTechContact Password) 

Retrieves a list of the customer's domain products for which the 

icuiiiiiucii LrUiiidui lu to Lilt? mufiiiiudi uunidCi. 


WSPResponse 


lookupDomainByTechContact (Strinq pCustomerAccountld, 




Strinq pTechContactld, Strinq pTechContactPassword, 
Properties optionalAttributes) 

Retrieves a list of the customer's domain products for which the 
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technical contact id is the technical contact. 


WSPResponse 


lookupDontainByTechContact (String pCustomerAccountld, 




Strinq pTechContactld, Strinq pTechCont act Pas sword. 
Strinq pDomainName) 

Retrieves details of a specific domain product owned by 
customer, for which the technical contact id is the technical contact for 
the specific product. 


WSPResponse 


lookupDomainByTechContact (String pCustomerAccountld. 




String pTechContactld, String pTechContactPassword. 
String pDomainName, Properties optionalAttributes) 

Retrieves details of a specific domain oroduct ownpd hv 
iruoiuiiici, lui wiiiuii uic icoiiitiLrcii uuiudui iu is me lecnnicai contact ror 
the specific product. 








.Retrieves a list of all individual accounts linked to a wholesaler. 


HorKcsponse 


looKupxnaivxaua xaccouijx itroperties optionalAttributes) 




Retrieves a list of all individual accounts linked to a wholesaler. 


WSPResponse 


lookup IndividualAccount (String pCustomerAccountld. 




OL1IIIC5 puUSLOIuciraSSwOra/ 

Retrieves details of a specific individual customer account. 




xooKupxaQiviQuaiACCounu liLLiny plus tOuiSrACCOUnc Iu , 




a tiing pLUbLotuerrdbbwora, rroperties opuionaiACtriDUtes ) 

Retrieves details of a specific individual customer account. 


WSPResponse 


lookupTechnicalContact (String pTechContactld) 




Retrieves details of a specific technical contact. 


WSPResponse 


lookupTechnicalContact (Strinq pTechContactld, 




Properties optionalAttributes) 

rceineves aeians ot a specific lecnnicai contact. 


WSPResponse 


modi fyBusinessAc count (String pCustomerAccountld, 




String pCustomerPassword) 

This method is used to modify one or more attributes of an 
existing uusiness lurganizaiionj customer account. 


WSPResponse 


modifyBusinessAccount (String pCustomerAccountld, 




String pCustomerPassword, Properties optionalAttributes) 

This method is used to modify one or more attributes of an 
existing uusiness (organization; customer account. 


WSPResponse 


modi fyDomain( String pCustomerAccountld, String plspPassword, 




String pDomainName, String aTechContactld) 

This method allows an Internet Service Provider (ISP) to modify 
the Technical Contact Id of a specific domain product. 


WSPResponse 


modi fyDomain( String pCustomerAccountld, String plspPassword, 




String pDomainName, String aTechContactld, 
Properties optionalAttributes) 

This method allows an Internet Service Provider (ISP) to modify 
the Technical Contact Id of a specific domain product. 
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WSPResponse 


modifyDomain (String pCustomerAccountld, 




String pCustomerPassword, Strincj pDomainName, String aHostldl 
Strinq aHostId2, String aTechContactld) 

This, method allows a customer to modify one or more attributes 
associated with a specific instance of a Domain product registered to 
that customer. 


WSPResponse 


modifyDomain (Strinq pCustomerAccountld, 




String pCustomerPassword, String pDomainName, Strinq aHostldl 
String aHostId2, String aTechContactld, 
Properties optionalAttributes) 

This method allows a customer to modify one or more attributes 
associated with a specific instance of a Domain product registered to 
that customer. 


WSPResponse 


modifyDomain (String pCustomerAccountld, String pTechContactld, 




String pTechContactPassword, String pDomainName, 

String aHostldl, String aHostId2, Strinq aTechContactld) 

This method allows a technical contact of a customer's domain 
product to modify one or more attributes associated with that specific 
instance of the Domain product registered to that customer. 


WSPResponse 


modifyDomain (String pCustomerAccountld, String pTechContactld, 




String pTechContactPassword, String pDomainName, 

String aHostldl, String aHostId2, String aTechContactld. 

Properties optionalAttributes) 

This method allows a technical contact of a customer's domain 
product to modify one or more attributes associated with that specific 
instance of the Domain product registered to that customer. 


WSPResponse 


modifyDomain (String pCustomerAccountld, 




String pCustomerPassword, String pDomainName, 

Strinq aHostNamel, Strinq aHostAddrl, Strinq aHostName2, 

String aHostAddr2, String aTechContactld) 

This method allows a customer to modify one or more attributes . 
associated with a specific instance of a Domain product registered to 
that customer. 


WSPResponse 


modifyDomain (String pCustomerAccountld, 




String pCustomerPassword, String pDomainName, 

String aHostNamel, String aHostAddrl, Strinq aHostName2, 

String aHostAddr2, String aTechContactld, 

Properties optionalAttributes) 

This method allows a customer to modify one or more attributes 
associated with a specific instance of a Domain product registered to 
that customer. 


WSPResponse 


modifyDomain (String pCustomerAccountld, Strinq pTechContactld, 




String pTechContactPassword, Strinq pDomainName, . 

ocxriny dnosLwamei, oLriny anostHuuri , otrmq anOSCName2, 

String aHostAddr2, String aTechContactld) 

This method allows a technical contact of a customer's domain 
product to modify one or more attributes associated with that specific 
instance of the Domain productregistered to that customer. 
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WSPResponse 


modifyDomain(Strincj pCustomerAccountld, String pTechContactTri f 




Strinq pTechContactPassword, String pDomainName, 
Strinq aHostNamel, String aHostAddrl, String aHostName2, 
String aHostAddr2, String aTechContactld, 
Properties optionalAt tributes) 

This method allows a technical contact of a customer's domain 
product to modify one or more attributes associated with that specific 
instance of the Domain oroduct reaistered to that customer 

II IWIUI iww Wl 11 IW \—S W 1 1 lull 1 fSI WUUVl 1 UMIWIWI V/VJ iw 11 icji vuwlvl 1 Id » 


WSPResponse 


modifylndividualAccount (String pCustomerAccountld, 




String pCustoraer Pas sword) 

This method is used to modify one or more attributes of an 
eyistino individual customer account 

CAIOUI IU II IVJI V IUUUI VUwlVlllVl OvvvUllli 


WSPResponse 


modifylndividualAccount (String pCustomerAccountld, 




String pCustomerPassword, Properties optionalAttributes) 

This method is used to modify one or more attributes of an 
evistino individual customer account 


WSPResponse 


modi fyPas sword (String pCustomerAccountld, 




String aCustomerPassword) 

This method is used to modify/reset a customer's account 

nassword 


WSPResponse 


modifyPassword( String pCustomerAccountld, 




String aCustomerPassword, Properties optionalAttributes) 

This method is used to modify/reset a customer's account 

nassword 


WSPResponse 


modi fyTechnical Contact (String pTechContactld, 




String pTechContact Pas sword) 

This method is used to modify one or more attributes of an 
evistino technical contact 

CAioui ly i^k^i ii iiiscii wi ikciv/L* 


WSPResponse 


modifyTechnicalContact (String pTechContactld, 




String pTechContactPassword, Properties optionalAttributes) 

This method is used to modify one or more attributes of an 
existing technical contact. 


WSPResponse 


quitO 

This method terminates the wholesaler's access to session 
commands. 


WSPResponse 


quit (Properties optionalAttributes) 

This method terminates the wholesaler's access to spssion 

1 1 IIO 1 1 ICU luU IUI 1 1 ill ii iw ¥V 1 IwlvvCII wl O CIvwOw \\J OUOOIUI 1 

commands. 


void 


shutdown () 

This method shutsdown the Wholesaler Services Protocol API 

1 1 IIO 1 1 Iwll lv vl Ol lUlwUvVVI I VI 1^ I VI Ivlvwuld VJd VIvvO II vlUvvl / VI 1 . 


WSPResponse 


verifyDoxnainName (String pDomainName) 




This method verifies whether or not a specified domain name is 
available. 


WSPResponse 


verifyDomainName (String pDomainName, 




Properties optionalAttributes) 
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This method verifies whether or not a SDecified domain namo «e 
available. 


WSPResponse 


verifyDomains (String pDomainTarget) 




i nis rneinoo veniico u oenes oi uornains are avanaDie. 


WSPResponse 


verifyDomains (Strinq pDomainTarget, 




Properties optionalAttributes) 

This method verifies if series of domains are availahlp 

■ 1 llw H IV/ll IvU V wl Mlw\J II wwliww Wl \J \J II lull Iw Ul W CI V CI II CI L/l w • 


WSPResponse 


verif yPassword (String pCustomer Account Id, 




Strinq pCustomerPassword) 

This method verifies whether or not a specified customer 
account id and password are valid. 


WSPResponse 


verif yPassword (String pCustomerAccountld, 




Strinq pCustomerPassword, Properties optionalAttributes) 

This method verifies whether or not a specified customer 
account id and password are valid. 



Methods inherited from class java.lang. Object 

equals , getClass , hashCode , notify , notifyAll , toString , wait, wait , wait 



The WSPResponse class represents the various components of a WSP response. A 
WSPResponse will be returned for command request that are issued through the application 
program interface 14. The response will describe, in as much detail as possible, the result of the 
issued request, and will optionally include any additional information that was generated by the 
request. A result consists of a "result code" followed by a descriptive "result message." The result 
code consists of a major result code followed by a period (7), followed by a minor result code. 

The three-digit major result code provides a general indication of the success or failure of 
an issued request. In most cases, one or more result properties are returned. The three-digit minor 
result code may provide additional information about the major result code. Each command 
request has its own set of minor result code values or may have the value (000). The 
WSPResponse and the result code are described in more detail in the aforementioned copending 
U.S. Patent Application Serial No. 09/544,305. " A result property consists of a property key 
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followed by a colon (V), followed by a property value. In some results, plain text is returned (e.g. 
information returned from the Help command). The result property is described in more detail in 
the aforementioned copending U.S. Patent Application Serial No. 09/544,305. The class definition 
for WSPResponse includes the following: 

5 



Constructor Summary 

WSPResponse ( String data) 

Parses a WSP text response and extracts and stores the various components. 



Method Summary 


static void 


displayResponse (WSPResponse response) 

prints debug-type representation of the WSP Response to 
standard output 


static String 


getJdkVersion ( ) 

Static accessor method to get JDK version 


int 


getMa j orResul tCode ( ) 

returns the WSP resnon^p mainr rp<;ult mr\& 


int 


getMinorRe suit Code ( ) 

returns the WSP response minor result code 


Properties 


getProperties ( ) 

Returns a property list containing all result property 
specifications, if applicable, extracted from the original WSP text 
response. 


static Properties 


getProperties (WSPResponse wspResponse) 




Returns a property list containing all result property 
specifications, if applicable, extracted from the original WSP text 
response. 


String 


getPrqperty (String resultPropertyKey) 

returns the result property value corresponding to the 
specified result property key, if found, extracted from the original 
WSP text response. 


String 


getRawResponse () 

Returns the original WSP text response string used to 
instantiate object. 


String 


getResultCode ( ) 

returns the WSP response result code 


String 


getResultCodeAndMessage ( ) 
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returns the WSP response result code and result message 


String 


getResultMessage ( ) 

Returns the result message extracted from the original WSP 
text response. 


static long 


getSerial Version ( ) 

Static accessor method to get serial version 


Vector 


getTextO 

returns a vector containing lines of text returned in the WSP 
response. 


static double 


getVersion() 

Static accessor method to get release version 


String 


toStringO 

returns the raw WSP response 



Methods inherited from class java.lanq. Object 

equals , getclass f hashCode , notify , notifyAll , wait , wait , wait 



The NSIWholesaleException class is a user-defined exception class denoting a special error 
thrown by the methods in the class NSIWholesaleAPI. In particular, exceptions of the class 
NSIWholesaleException are thrown (a) when class initialization fails; (b) when a method in 
NSIWholesaleAPI is called without successfully initializing the class; (c) when a command cannot 
be completed (for example due to communications problems); or (d) to reframe an NSIException 
thrown at a lower level to give additional context information. 

The class WSPException is the parent for wholesale protocol exception classes which 
processes responses sent by Wholesale Server 16 to computer application program 12. This is a 
service class, not used explicitly. It furnishes the base methods for storing error information 
common to all exception classes. 

The classes InvalidArgumentException and InvalidResponseFormatException are the 
detail class children of WSPException. Both methods have the same internal functionality as 
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WSPExcepton. In addition, both classes are independent, so that methods receiving the thrown 
exceptions know the type of error detected, even if the error context information is identical. In 
particular, the WSPResponse class throws InvalidArgumentException if the data returned by 
Wholesale Server 16 as part of a command, is invalid. The WSPResponse class throws class 
InvalidResponseFormatException if the data returned by the Wholesale Server 16 as part of a 
command, is not properly formatted. The class definition for NSIWholesaleException includes 
the following: 



Constructor Summary 


NSIWholesaleException ( ) 




NSIWholesaleException (String message) 




NSIWholesaleException (String message, Throwable throwable) 




NSIWholesaleException (Throwable throwable) 





Method Summary 


static Strinq 


get JdkVersion ( ) 

Static accessor method to get JDK version 


static long 


getSerialVersionO \ 

Static accessor method to get serial version 


static double 


getVersionO 

Static accessor method to get release version 


String 


toStringO 



10 



Methods inherited from class javaJang.Throwable 

fill InS tackTrace , getLocalizedMessage , getMessage , printStackTrace , 
prints tackTrace , printStackTrace 
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Methods inherited from class iava.lanq. Oblect 

equals , getClass , hashCode, notify , notifyAll , wait , wait , wait 



The class definition for WSPException includes the following: 



Constructor Summary 


WSPException () 




WSPException (String message) 


WSPException (String message, Throwable x) 





Method Summary 


static String 


get JdkVersion ( ) 

Static accessor method to get JDK version 


String 


getMessageO 


static long 


getSerialVersion ( ) 

Static accessor method to get serial version 


static double 


getVersionO 

Static accessor method to get release version 



Methods inherited from class iava.lanq. Throwable 

f illlnStackTrace , getLocalizedMess age , printStackTrace , printStackTrace , 
printStackTrace , toString 



Methods inherited from class java.lang. Object 

equals , getClass , hashCode , notify , notifyAll , wait , wait , wait 



The class definition for InvalidArgumentException is as follows: 



Constructor Summary 

InvalidArgumentException ( ) 
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InvalidArgumentException ( String message) 
InvalidArgumentException ( Strinq message, Throwable x) 



Method Summary 


static String 


getJdkVersionO 

Static accessor method to get JDK version 


String 


getMessageO 


static long 


getSerialVersion ( ) 

Static accessor method to get serial version 


static double 


getversionO 

Static accessor method to get release version 



Methods inherited from class iava.lanq. Throwable 

f illlnStackTrace , getLocalizedMessage , pr intStackTrace , pr intStackTrace , 
printStackTrace , toString 



Methods inherited from class iava.lang. Object 

equals , getClass , hashCode , notify , notifyAll , wait, wait , wait 



The class definition for InvalidResponseFormatException includes the following: 



Constructor Summary 


InvalidResponseFormatException ( ) 




InvalidResponseFormatException (Strinq message) 




InvalidResponseFormatException (String message, Throwable x) 





Method Summary 



static Strinq getJdkVersionO 
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Static accessor method to get JDK version 


Strinq 


getMessage ( ) 


static long 


getSerialVeraion ( ) 

Static accessor method to get serial version 


static double 


getVersionO 

Static accessor method to get release version 



Methods inherited from class iava.lanq. Throwable 

f illlnSt ackTr ace , getLocalize dMe s s age , printStackTrace , printStackTrace , 
printStackTrace , toString 



Methods inherited from class iava.lang. Object 

equals , getClass , hashCode , notify , notifyAll , wait , wait , wait 



The invention will be further clarified by the following example showing a computer 
program file for creating a session with a Wholesale system to begin Wholesale operation, which is 
intended to be purely exemplary of the invention. ■ 



7^— — — 

* :-- Copyright {c) 2000 Network Solutions, Inc . <BR> 

* 

* This class is a demonstration program for use case i: Creating a session 

* with NSI to begin wholesale operations. 
* 

* This class assumes the existance of the file WSPjavaAPI . conf , which was set 

* up in running the installation test earlier. 
* 

*<BR> <BR> 

*/ 

// Imports 

import java.util.*; 

import j ava . io . * ; 

import nsi. wholesale. toolki t. javaapi.util . resourcepool . * ; 

import ns i. wholesale. toolkit .javaapi. *; 

// 

class NSIUseCasel 

}/-•—■- - . - - - 

public static void main (String argsl]) 
{ 

NSIWholesaleAPI api e null; 

// Use the properties from the configuration file to establish a session 
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try { 

NSIWholesaleAPI . init ( "WSPjavaAPI .conf " ) ; 
catch {NSIWholesaleException e) 

Sys tern. out. print ("Unable to initialize NSI Wholesale API:" + e) ; 

System. exit (1) ; 

) 

//Having initialized the NSI Wholesale API # we now need to 

// create an instance of the API by calling constructor NSIWholesaleAPI () 

try { 

api o new NSIWholesaleAPI () ; 
} 

catch (NSIWholesaleException e) 

System. out .print ("Unable to initialize NSI Wholesale API : M + e) ; 

System. exit (1) ; 

} 

// 

//At this point, if no error has been thrown, then the session 
// is established, and a number of connections have been opened 
// in the connection pool. 
// 

// 

// Here, the call to methods on "api" are used to perform 

// wholesale related activities. For this use case, 

// there are none. 

// 

// End the session. This is done by calling the shutdown method on the 
// instance of the wholesale API that was created earlier, 
api .shutdown () ; 
} 

} . 



The WSP Java API 14 is an implementation of the WSP. In every case where the WSP 
Java API 14 is used, the first steps are to initialize a session and then create an instance of the class 
to reference the methods. Individual calls to methods are instances of a single protocol exchange. 
5 Each call contains all necessary information (e.g., customer identification, contact information). 

Except for session information, no information carries over from method to method. 

As the example shows, the first evocation of a routine in the WSP Java API 14 is to the 
class method NSIWholesaleAPI.init to initialize the interface to the Wholesale System 16. The 
second evocation, creates an instance of the class NSIWholesaleAPI, which makes available to the 
10 application program 12 the methods to send commands to the Wholesale System 16. The 

application program 12 can now send command requests to the application program interface 14. 
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The last evocation is to the shutdown method, which ends the session with the Wholesale System 
16. 

It is to be noted that in the above description, references to Network Solutions, Inc. and 
NSI, including but not limited to references which are imbedded in the examples given of classes, 
methods, constructors, drawings, and the like, are intended to be exemplary only and not restricted 
to any particular implementation. 

While the foregoing description is based on a client-server architecture, those skilled in the 
art will recognize that other types of architecture may be used consistent with the invention. In 
addition, while the foregoing description is based on a software implementation, other • 
implementations may be used consistent with the invention. Further, while the foregoing 
description is based on the Java language, those skilled in the art will recognize that other types of 
language may be used consistent with the invention. Therefore, it is intended that this invention 
not be limited to the particular implementation and method disclosed herein, but that the invention 
include all implementations falling within the scope of the appended claims. 

The foregoing description is presented for illustration and explanation. It is not intended to 
be exhaustive or to limit the invention to the precise form disclosed, and modifications of 
variations are possible in light of the above teachings or may be acquired from practice of the 
invention. The principles of the invention and its practical application enable one skilled in the art 
to utilize the invention in various embodiments and with various modifications as are suited to the 
use contemplated. 

The class definition for NSIWholesaleAPI is as follows: 

// 

// Package 

// - -- - ---——a 

package nsi .wholesale . toolkit . javaapi ; 



WO 01/20484 




'CT/US00/25305 



// - 

// Imports. . . 

// - - - 

import java. io. Li neNumber Reader; 

import java.io.FileReader; 

import java.io.IOException; 

import java.io.FileNotFoundException; 

import java.util. StringTokenizer; 

import java.util. Properties; 

import java.util . Enumeration; 

import java.util .NoSuchElementException; 

import nsi . wholesale . toolkit . j avaapi . uti 1 . resourcepool . Resource ; 

import nsi . wholesale . toolkit . j avaapi . util . resourcepool . ResourceException ; 

/** 

* - Copyright (c) 2000 Network Solutions, Inc 

<BR> 

* 

* This Java -based Wholesale Services Protocol (WSP) API provides 

* programmer access to the Wholesale Services Protocol Server. 

* The Wholesale Services Protocol (WSP) is a simple, connection-based, 

* ASCII text-based protocol. It allows wholesalers to securely and 

* reliably create, modify, and lookup customer accounts and various 

* products via a single client/server interface. 
* 

*<BR>-- -- 

<BR> 

* $Log$ 

*<BR> ..... 

<BR> 
*/ 

public class NSIWholesaleAPI 
{ 

//------- ---- - - 

// Beginning of Required/Standard Fields 

// _ 

/** Serial Version */ 

static long serialVersion = 1L; 

/** Release Version */ 
static double version = 1.1D; 

/** SCCS control ID */ 

static final String sccsID « wholesale-sdk_dl . 12 . 1 . 3 08/04/00 

10:27:19 NSIWholesaleAPI . j ava NSI"; 

/** JDK Version */ 
' static String jdkVersion = M 1.1.7"; 

// Static Accessor Method (s) ... 

/** Static accessor method to get serial version */ . 

static public long getSerialVersion ( ) { return serialVersion; } 



/** Static accessor method to get release version */ 
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static public double getVersionO { return version; } 

/** Static accessor method to get JDK version */ 

static public String get JdkVersion 0 { return jdkVersion; } 

// - 

// End of Required/Standard Fields 

//----- - - - - ----- 

//--- - __-------. ... 

// class (static) variable (s) ... 

// - : rz — 

/** The name of this class */ 

private static final String className ■ "NSIWholesaleAPI" ; 
/** Connection pool */ 

protected static NSIWholesalePool pool - null; 

/** Retry count */ 

protected static int retry = 1; 

// Supported Commands 

// _____ __ ..... 

/** Ease-of-use constant for Command: Session */ 

public static final String COMMAND_SESSION = "Session"; 

/** Ease-of-use constant for Command: Describe */ 

public static final String COMMAND_DES CR I B E = "Describe"; 

/■** Ease-of-use constant for. Command: Verify */ 

public static final String COMMAND_VE R I F Y = "Verify"; 

/** Ease-of-use constant for Command: Create */ 

public static final String COMMAND_CREATE = "Create"; 

/** Ease-of-use constant for Command: Delete */ 

public static final String COMMANDJDELETE = . "Delete"; 

/** Ease-of-use constant for Command: Modify */. 

public static final String COMMAND_MOD I FY = "Modify"; 

/** Ease-of-use constant for Command: Renew */ 

public static final String COMMAND_RENEW = "Renew"; 

/** Ease-of-use constant for Command: Generate */. 

public. static final String COMMAND_GENERATE = "Generate"; 

/** Ease-of-use constant for Command : Lookup */ 

public static final String C0MMAND_LO0KUP = "Lookup"; 

/** Ease-of-use constant for Command: Help */ 

public static final String COMMAND_HELP = "Help"; 

/** Ease-of-use constant for Command: Quit */ 

public static final String COMMAND_QUIT = "Quit"; 

// Supported Classes 

// _---_--__ — __________ 

/** Ease-of-use constant for Class: DomainName */ 
public static final. String CLASS_DOMAIN_NAME .= "DomainName"; 
/** Ease-of-use constant for Class: Domains */ 
public static final String CLASS_DOMAINS = "Domains"; 
/** Ease-of-use constant for Class: Password */ 
public static final String CLASS_PASSW0RD = "Password"; 
/** Ease-of-use constant for Class: IndividualAccount */ 
public static final String CLASS^INDIVIDUAL^ACCOUNT = 
"IndividualAccount"; 

/** Ease-of-use constant for Class: BusinessAccount */ 
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public static final String CLASS_BUSINESS_ACCOUNT = "BusinessAccount" ; 

/** Ease-of-use constant for Class: TechnicalContact */ 

public static final String CLASS_TECHNICAL_CONTACT = "TechnicalContact"; 

/** Ease-of-use constant for Class: Domain */ 

public static final String CLASSJDOMAIN *= "Domain"; 

/** Ease-of-use constant for Class: DnsHosting */ 

public static final String CLASS_DNS_HOSTING = "DnsHosting"; 

// Supported Command-Class Combinations 

// - - - - - 

/** Ease-of-use constant for Command-Class Combination: VerifyDomainName 

*/ 

public static final String COMBO_VERIFYJX)MAIN_NAME o COMMAND_VERIFY + " 
" + CLASS_DOMAIN_NAME; 

/** Ease-of-use constant for Command-Class Combination: Verify Domains 

*/ 

public static final String COMBO_VERIFY_DOMAINS « COMMAND__VERIFY + " » + 
CLASS_DOMAINS; 

/** Ease-of-use constant for Command-Class Combination: Verify Password 

*/ 

public static final String COMB0_VERIFY_PASSW0RD = COMMAND_VERIFY + " " 
+ CLASS_PASSWORD; 

/** Ease-of-use constant for Command-Class Combination: Create 
IndividualAccount */ 

public static final String COMBO_CREATE_INDIVIDUAL_ACCOUNT = 
COMMAND_CREATE + " " + CLASS_INDIVIDUAL_ACCOUNT; 

/** Ease-of-use constant for Command-Class Combination: Create 
BusinessAccount */ 

public static final. String COMBO_CREATE_BUSINESS_ACC0UNT = 
COMMAND_CREATE + " " + CLASS_BUSINESS_ACCOUNT; 

/** Ease-of-use constant for Command -Class Combination: Create 
TechnicalContact */ 

public static final String COMBO_CREATE_TECHNI CAL_CONTACT = 
COMMAND_CREATE + " " + CLASS_TECHNICAL_CONTACT; 

/** Ease-of-use constant for Command-Class Combination: Create Domain */ 

public static final String COMBO_CREATE_DOMAIN = COMMAND_CREATE + ». " + 
CLASSJDOMAIN; 

/** Ease-of-use constant for Command-Class Combination: Create 
DnsHosting */ 

public static final String COMB0_CREATE_DNS_H0STING = COMMAND_CREATE + " 
" + CLASS_DNS_HOSTING; 

/** Ease-of-use constant for Command -Class. Combination: Delete Domain */ 
public Static final String COMBO__DELETE__DOMAIN = COMMAND_DELETE + " " + 
CLASSJDOMAIN; 

/** Ease-of-use constant for Command-Class Combination: Delete 
DnsHosting */ 

public static final String COMBO_DELETE_DNS_HOSTING = COMMANDED ELETE + " 
" + CLASS_DNS_HOSTING; 

/** Ease-of-use constant for Command-Class Combination: Delete 
IndividualAccount */ 

public static final String COMB0_DELETE_INDIVIDUAL_ ACCOUNT = 
COMMANDJDELETE + " " + CLASS_INDIVIDUAL_ACCOUOT; 

/** Ease-of-use constant for Command-Class Combination: Delete 
BusinessAccount */ 
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public static final String COMBO_DELETE_BUSINESS_ACCOUNT = 
COMMAND_DELETE + " " + CLASS_BUSINESS_ACCOUNT; 

/** Ease-of-use constant for Command -Class Combination: Modify Domain */ 
public static final String COMBO_MODIFY_DOMAIN = COMMAND_MOD I FY + »• »» + 
CLASS_DOMAIN; 

/** Ease-of-use constant for Command-Class Combination: Modify 
IndividualAccount */ 

public static final String C0MB0J40D I FY_ INDIVIDUALACCOUNT = 
COMMAND_MOD I FY + " » + CLASS_INDIVIDUAL_ACCOUNT; 

/** Ease-of-use constant for .Command-Class Combination: Modify 
BusinessAccount */ 

public static final String COMBO_MODIFY_BUSINESS_ACCOUNT = 
COMMAND_MOD I FY + " " + CLASS_BUSINESS_ACCOUNT; . .. 

/** Ease-of-use constant for Command-Class Combination: Modify 
TechnicalContact */ 

public static final String COMBO_MODIFYJTECHNICAL_CONTACT = 
COMMAND_MOD I FY + " " + CLASS_TECHNICAL_CONTACT; 

/** Ease-of-use constant for Command-Class Combination: Modify Password 
*/ - 

public static final String COMBO_MODIFY_PASSWORD = COMMAND_MODIFY + " " 
+ CLASS_PASSWORD; 

/** Ease-of-use constant for Command-Class Combination: Renew Domain */ 
public static final String COMBO_RENEW_DOMAiN = COMMAND^ RENEW + M « + 
CLASSJDOMAIN; 

/** Ease-of-use constant for Command-Class Combination: Renew DnsHosting 

*/ 

public static final String COMBO_RENEW_DNS_HOSTING ■ COMMAND_RENEW + " » 
+ CLASS_DNS_HOSTING; 

/** Ease-of-use constant for Command -Class Combination 
DomainName */ • " 

public static final String COMBO_GENERATE_DOMAIN_NAME 
+ " " + CLASS_DOMAIN_NAME ; 

/** Ease-of-use constant for Command-Class Combination: Lookup Domain */ 
public static final String COMB0_LO0KUP_D0MAIN = COMMAND_LOOKUP + '•■ " + 
CLASSJDOMAIN; 

/** Ease-of-use constant for Command-Class Combination: Lookup 
DnsHosting */ 

public static final String COMB0_LO0KUP_DNS_H0STING = COMMAND_LOOKUP + " 
" + CLASS JDNSJiOSTING; 

/** Ease-of-use constant for Command- Class Combination: Lookup 
IndividualAccount */ 

public static final String COMBO_LOOIOJP_INDIVIDUAL_ACCOUNT = 
COMMAND_LOOKUP + " " + CLASS_INDIVIDUAL_ACCOUNT; 

/** Ease-of-use constant for Command - Clas s . Combination: Lookup 
BusinessAccount */ 

public static final String COMB0_L0OKUP_BUSINESS_ACCOUNT = 
COMMAND JjOOKUP + " " + CIASS J3USINESS_ACCOUNT; 

/** Ease-of-use constant for Command-Class Combination: Lookup 
TechnicalContact */ 

public static final String COMBOJ^OKUPJTECHNICALjCONTACT = 
COMMAND JiOOKUP + " " + CLASS JTECHNICALJttNTACT; 
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// -- 

/** Ease-of-use constant for Attribute Key: FirstName */ 

public static final String ATTR_F I RS T_N AM E = " FirstName " ; 

/** Ease-of-use constant for Attribute Key :. LastName */ 

public static final String ATTR_LAST_NAME .=* "LastName"; 

/** Ease-of-use constant for Attribute Key: Addressl */ 

public static final String ATTR_ADDRESS1 = "Addressl"; 

/** Ease-of-use constant for Attribute Key: Address2 */ 

public static final String ATTR_ADDRESS2 = "Address2"; 

/** Ease-of-use constant for Attribute Key: Address3 */ 

public static final String ATTR_ADDRESS3 - "Address3"; 

/** Ease-of-use constant for Attribute Key: Address4 */ 

public static final String ATTR_ADDRESS4 = " Address4 " ; 

/** Ease-of-use constant for Attribute Key: AddressS */ 

public static final String ATTR_ADDRESS5 = "Address5"; 

/** Ease-of-use constant for Attribute Key: City */ 

public static final String ATTR_CITY - "City"; 

/** Ease-of-use constant for Attribute Key: State */ 

public static final String ATTR_STATE = "State"; 

/** Ease-of-use" constant for Attribute Key: PostalCode */ 

public static final String ATTR_POSTAL_CODE = "PostalCode"; 

/** Ease-of-use constant for Attribute Key: CountryCode */ 

public static final String ATTR_COUNTRY_CODE = "CountryCode"; 

/** Ease-of-use constant for Attribute Key: Phone */ 

public static final String ATTR_PHONE = "Phone" ; 

/** Ease-of-use constant for Attribute Key: Fax */ 

public static final String ATTR_FAX = "Fax"; 

/** Ease-of-use constant for Attribute Key: Email */ 

public static final String ATTRJSMAIL = "Email"; 

/** Ease-of-use constant for Attribute Key: CustomerAc count Id */ 

public, static final String ATTR_CUSTOMER_ACCOUNT_ID = 

"CustomerAccountld" ; 

/** Ease-of-use constant for Attribute Key: CustomerPassword */ 

public static final String ATTR_CUSTOMER_P AS S WORD * "CustomerPassword" 

/** Ease-of-use constant for Attribute Key: AuthQuestion */ 

public static final String ATTR_AUTH_QUESTION = "AuthQuestion"; 

/** Ease~-of-use constant for Attribute Key: AuthAnswer */ 

public static final String ATTR_AUTH_ANSWER = "AuthAnswer"; 

/** Ease-of-use constant for Attribute Key: CompanyName */ 

public static final String ATTR_COM P AN Y_ NAME = "CompanyName"; 

/** Ease-of-use constant for Attribute Key: CompanyType */ 

public static final String ATTR_COMPANY_TYPE » "CompanyType"; 

/** Ease-of-use constant for Attribute Key: LegalContactFirstName */ 

public static final String ATTR_LEGAL_CONTACT^FIRST_NAME ■ . " 

"LegalContactFirstName"; 

/** Ease-of-use constant for Attribute Key: LegalContactLastName */ 
public static final String ATTR_LEGAL_CONTACT_LAST_NAME = 

"LegalContactLastName"; 

/** Ease-of-use constant for Attribute Key: LegalContact Addressl */ 
public static final String ATTRJLEGAL_C0NTACT_ADDRESS1 = 

"LegalContactAddressl" ; 

/** Ease-of-use constant for Attribute Key: LegalContactAddress2 */ 
public static final String ATTR_LEGAL_CONTACT_ADDRESS2 = 

"LegalContactAddress2 " ; 

/** Ease-of-use constant for Attribute Key: LegalContactAddress3 */ 
public static final String ATTR_LEGAL_CONTACT_ADDRES S 3 ■ 

"LegalContactAddress3 " ; 
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/** Ease-of-uge constant for Attribute Key: LegalContactAddress4 */ 
public Static final String ATTR_LEGAL_C0NTACT_ADDRESS4 = 
"LegalContactAddress4 " ; 

/** Ease-of-use constant for Attribute Key: LegalContactAddressS */ 
5 public static final String ATTR_LEGAL_CONTACT_ADDRESS 5 = 

"LegalContactAddressS"; 

/** Ease-of -use constant for Attribute Key: LegalContactCity */ 

public static final String ATTR_LEGAL_CONTACT_CITY a "LegalContactCity" 

/** Ease-of-use constant for Attribute Key: LegalContactState */ 

10 public Static final String ATTR_LEGAL_CONTACT_STATE = 

"LegalContactState"; 

/** Ease-of-use constant for Attribute Key: LegalContactPostalCode */ 
public Static final String ATTR_LEGAL_CONTACT_POS TAL_CODE = 
"LegalContactPostalCode"; 

15 /** Ease-of-use constant for Attribute Key: LegalContactCountryCode */ 

public Static final String ATTR_LEGAL_CONTACT_COUNTRY_CODE = 
"LegalContactCountryCode"; 

/** Ease-of-use constant for Attribute Key: Lega 1 Contact Phone . */ 
public static final String ATTR_LEGAL_CONTACT_PHONE = 

20 " LegalContact Phone " ; 

/** Ease-of-use constant for Attribute Key: LegalContactFax */ 
public static final String ATTR_LEGAL_CONTACT_FAX = "LegalContactFax"; 
/** Ease-of-use constant for Attribute Key: LegalContactEmail */ 
public static final String ATTRJLEGAL_CONTACT_EMAIL = 

25 "LegalContactEmail"; 

/** Ease-of-use constant for Attribute Key: Organization */ 
public static final String ATTR_ORGAN I Z AT I ON = "Organization"; 
/** Ease-of-use constant for Attribute Key: TechContactPassword */ 
public static final String ATTR_TECH_CONTACT_PASSWORD = 

30 "TechContactPassword"; 

/** Ease-of-use constant for Attribute Key: DomainName */ 
public static final String ATCR_DOMAIN_NAME = "DomainName";" 
/** Ease-of-use constant for Attribute Key: HostNamel */ 
public static final String ATTR_H0ST_NAME1 = "HostNamel"; 

35 /** Ease-of-use constant for Attribute Key: HostAddrl */ 

public static final String ATTR_H0ST_ADDR1 = "HostAddrl"; 
/** Ease-of-use constant for Attribute Key: HostName2 */ 
public static final String ATTR_HOST_NAME2 = "HostName2"; 
/** Ease-of-use constant for Attribute Key: HostAddr2 */ 

40 public static final String ATTR_HOST_ADDR2 = "HostAddr2"; 

/** Ease-of-use constant for Attribute Key: Hostldl */ 
public static final String ATTR_H0ST_ID1 = "Hostldl"; 
/** Ease-of-use constant for Attribute Key: HostId2 */ 
public static final String ATTR_H0ST_TD2 = "HostId2"; 

45 /** Ease-of-use constant for Attribute Key: TechContactld */ 

public static final String ATTRJTECH_CONTACT_ID = "TechContactld"; 
/** Ease-of-use constant for Attribute Key: IspPassword */ 
public static final String ATTR_ISP_PAS SWORD = "IspPassword"; 
/** Ease-of-use constant for Attribute Key: Protocol (returned by 

50 Describe) */ 

public static final String ATTR_PROTOCOL = "Protocol"; 
/** Ease-of-use constant for Attribute Key: Dns Hosting Created 
(returned by Create DnsHosting) */ 

public static final String ATTR_DNSJHOSTING_CREATED = "Dns Hosting 

55 Created"; 

// Supported Parameters 
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// - 

/** Ease-of-use constant for Parameter Key: -WholesalerAccountld */ 
public static final String PARM_WHOLESALER_ACCOUNT_ID = "- 
WholesalerAccountld" ; 
5 /** Ease-of-use constant for Parameter Key: -WholesalerPassword */ 

public static final String PARM_WHOLESALER_PASSWORD = »- 
WholesalerPassword" ; 

/** Ease-of-use constant for Parameter Key: -Target */ 
public static final String PARMJTARGET = "-Target"; 
10 /** Ease-of-use constant for Parameter Key: -DomainTarget */ 

public static final String PARM_DOMAIN_TARGET = "-DomainTarget"; 
/** Ease-of-use constant for Parameter Key: -Keywords */ 
public static final String PARM_KEY_WORDS = "-Keywords"; 
/** Ease-of-use constant for Parameter Key: -CustomerAccountld */ 
15 public static final String PARM_CUSTOMER_ACCOUNT_ID = "-» + 

ATTR_CUSTOMER_ACCOUNT_ID ; 

/** Ease-of-use constant for Parameter Key: -CustomerPassword */ 
public static final String PARM_CUSTOMER_PASSWORD =■«-" + 
' ATTR_CUSTOMER_PASSWORD; 
20 /** Ease-of-use constant for Parameter Key: -DomainName */ 

public static final String PARM_DOMAIN_NAME = "-" + ATTR_DOMAIN_NAME ; 
/** Ease-of-use constant for Parameter Key: -TechContactld */ 
public static final String PARM_TECH_CONTACT_ID + 
ATTRJTECH_CONTACT_ID; 
25 /** Ease-of-use constant for Parameter Key: -TechContactPassword */ 

public static final String PARM_TECH_CONTACT_PAS SWORD = »-« + 
ATTRJTECH_CONTACT_PASSWORD ; 

/** Ease-of-use constant for Parameter Key: -IspPassword */ 
public static final String PARM_ISP_PAS SWORD = "-" + ATTR ISP PASSWORD 
30 " 

// . 

// class (static) method(s) ... r 

// . 

35 /** 

* Initializes the Wholesale Services Protocol API. 
* 

* ©param String name of configuration files containing property list 

* ©return void 

40 * ©see NSIWholesaleAPI#init 

* ©exception nsi .wholesale . toolkit .javaapi .NSIWholesaleException if 
initialization fails 

*/ 

public static void init (String conf igFileName) 
45 throws NSIWholesaleException { 

System. out .print In ( "NSIWholesaleAPI . init (String) started" ) ; 
Properties configProps = new Properties () ; 
try { 

LineNumberReader in = new LineNumberReader (new 
50 FileReader (conf igFileName) ) ; 

String line = in. readLine ( ) ,- 
while (line != null) { 

line = line, trimO ; 

if ( (line. length () > 0) && (line. star tsWith("#") == 

55 false) ) { 

try { 
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StringTokenizer st « new 

StringTokenizer (line, " = "); 

String propertyKey = st . nextToken { ) ; 
String propertyValue = st : next Token () ; 
configProps .put (propertyKey, 

propertyValue); 

} 

catch (NoSuchElementException nsee) { 

Sys tern. err. println( "NSIWholesaleAPI. init (String) : Error Reading Config 
File" + nsee) ; 

throw new NSIWholesaleException ( "Error 
reading Configuration File " + conf igFileName) ; 

} 

■ } . ■ . 

line = in.readLine () ; 

} 

} 

catch (FileNotFoundException fnfe) { 

System . err . print In ( "NSIWholesaleAPI . init (String) : 

Configuration File Not Found " + fnfe) ; 

throw new NSIWholesaleException ( "Conf igurat ion File Not 

Found " + conf igFileName) ; 

} 

catch (IOException ioe) { 

System. err. println ("NSIWholesaleAPI. init (String) : 10 
Exception reading configuration file " + ioe) ; 

throw new NSIWholesaleException (" 10 Exception reading 
configuration file 11 + conf igFileName) ; 

} 

catch (Exception e) { 

System. err. printing "NSIWholesaleAPI . init (String) : Exception 
reading configuration file " + e) ; 

throw new NSIWholesaleException ("Exception reading 
configuration file " + conf igFileName) ; 

} 

NSIWholesaleAPI . init (conf igProps) ; 

System. out .println ( "NSIWholesaleAPI . init (String) completed 
successfully"); 

} 

/** 

* Initializes the Wholesale Services Protocol API. 

* <BR> • 

* All of the following parameters should be 

* passed in through the properties file: 

<PRE> 

WholesaleAPI .minConnections - 

Connections to use on startup (1,2,5, 10) 

WholesaleAPI .maxConnections t 

Maximum Connections (5,10,20) 

WholesaleAPI. connect ionSoTimeout - (Provided by NSI) 

Enable/disable Socket SOjriMEOUT with the specified 

timeout, in milliseconds 
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WholesaleAPI .connectionProtocol - (Provided by NS I) 

Wholesale Services Protocol Version 
WholesaleAPI. server - (Provided by NSI) 

The secure wholesale server at NSI 
5 WholesaleAPI. port - (Provided by NSI) 

The port on that machine 
WholesaleAPI. retry - 

The retry count, if a transient error occurs (2,3) 

10 WholesaleAPI . WholesalerAccount Id - (Provided by NSI) 

The Wholesaler Account number 
WholesaleAPI .WholesalerPassword - (Provided by NSI) 
The Password for that account 

</PRE> 

15 

* ©param properties Properties, file containing configuration settings 

* ©return void 

* ©see NSIWholesaleAPItfNSIWholesaleAPI 

* ©exception nsi . wholesale . toolkit , javaapi .NSIWholesaleExcept ion if 
20 initialization fails 

*/ 

public static void init (Properties properties) 
throws NSIWholesaleException { 

System. out. print In ("NSIWholesaleAPI. init (Properties) started") ; 
25 int min = parselnt ( 

properties. getProperty ("WholesaleAPI .minConnect ions") ) ; 
int max = parselnt ( 

properties. getProperty ("WholesaleAPI .maxConnect ions" ) ) ; 
int connectionSoTimeout parselnt ( 
30 properties. getProperty ("WholesaleAPI. connectionSoTimeout") ) ; 

String connectionProtocol = 
properties. getProperty ("WholesaleAPI. connectionProtocol ") ; 

String server = properties . getProperty ( "WholesaleAPI . server" ) ; 
int port = parselnt (properties. getProperty ("WholesaleAPI. port" )) ; 
35 retry = parselnt (properties. getProperty ("WholesaleAPI. retry" )) ; 

String wholesalerAccountld = 

properties . getProperty ( "WholesaleAPI . WholesalerAccountld" ) ; 
String WholesalerPassword = 
40 properties. getProperty ("WholesaleAPI. WholesalerPassword") ; 

System, out .println( "connectionProtocol = 11 + connectionProtocol); 
System. out .print In ("server = " + server); 
45 System. out .print In ("port = " + port) ; 

System. out .println ("wholesalerAccountld = " + 
wholesalerAccountld) ; 

System. out .println ("WholesalerPassword = " + WholesalerPassword); 
System. out .println ( "NSIWholesaleAPI . init (Properties) constructing 
50 new NSIWholesalePool") ; 

pool = new NSIWholesalePool (server, port, min, max, 

wholesalerAccountld, WholesalerPassword, retry, 
connectionSoTimeout); 

NSIWholesaleAPI api = new NSIWholesaleAPI () ; 
55 if (api . ver if yConnect ionProtocol (connectionProtocol) != true) 

{ 

api = null; 
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throw new NSIWholesaleException ( "Failed to verify connection 
protocol n + connectionProtocol) 

} 

api « null; 

5 System. out .println( "NSIWholesaleAPI . init (Properties) completed 

successfully") ; 
} 

10 //- - --- 

// static initializer block . ... 

//---- — ---- 

// - ----- — - 

15 // instance Variable (s) ... 

// - - --- 

// 

// Constructor <s) 

20 // -_ - — 

/** 

* Constructs a new NSIWholesaleAPI object. NSIWholesaleAPI MUST have 

* been initialized BEFORE any NSIWholesaleAPI objects can be 
constructed. 

25 * ©see NSIWholesaleAPI#init 

* ©exception nsi .wholesale, toolkit .javaapi -NSIWholesaleException if 
NSIWholesaleAPI has not yet 

* been initialized 
*/ 

30 public NSIWholesaleAPI () throws NSIWholesaleException { 

if (pool == null) 

throw new NSIWholesaleException { "Must initialize API before 

use") ; 

} 



35 



40 



45 



// 

// Accessors and Mutators 
// 



// --- 

// General Methods 
// 

//#- -BEGIN API 



* This method is used to authenticate a wholesaler and to provide 

* the wholesaler with access to Session commands. Once a session 

* has been established, the Session command may not be issued 
50 * again 

* <BRxPRE> 

Expected Major Result Code: SES S ION — CREATED 

* </PRExBR> 

* ©param pWholesalerAccountld the parameter value 
55 * ©param pWholesalerPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 
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* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see COMMAND_SESSION 

* ©see PARM_WHOLES ALE_ACCOUNT_I D 

* ©see PARM_WHOLESALE_PASSWORD 

* ©see WSPResponse#SESSION_CREATED 

* ©see WSPResponse#AUTHENTICATION_FAILED 
* 

*/ 

WSPResponse session ( 

String pWholesalerAccountld, 

String pWholesalerPassword) 
throws NSIWholesaleException { 

return session ( pWholesalerAccountld, pWholesalerPassword, new 
Properties () , 0) ,* 
} 

/** 

* This method is used to authenticate a wholesaler and to provide 

* the wholesaler with access to Session commands. Once a session 

* has been established, the Session command may not be issued 

* again 

* <BR><PRE> 

Expected Major Result Code: SESSION_CREATED 

* </PRExBR> 

* ©param pWholesalerAccountld the parameter value 

* ©param pWholesalerPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server 'Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see COMMAND_SESSION 

* ©see PARM_WH0LESALE_ACCOUNT_ID 

* ©see PARM_WHOLESALE_PAS SWORD . 

* ©see WSPResponse#SESSION_CREATED 

* ©see WSPResponse#AUTHENTICATION_FAILED 
* 

*/ 

WSPResponse session ( 

String pWholesalerAccountld, 

String pWholesalerPassword, 

Properties optionalAttributes) 
throws NSIWholesaleException { 

return session (( pWholesalerAccountld, pWholesalerPassword, 
optionalAttributes, 0); 
} 

protected WSPResponse session ( 

String pWholesalerAccountld, 

String pWholesalerPassword, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName = className + " . session (String, String, 
Properties, int) M ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command") ; 



10 



15 
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NSIWholesaleConnection conn = null? 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () / 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs . put { PARM_WHOLESALER_ACCOUNT_ID , 
pWholesalerAccountld) ; 

allParmsAndAttrs .put (PARM_WHOLESALER_PAS SWORD, 
pWholesalerPassword) ; 



returnCode = conn. makeReques t (COMMAND_SESS ION, 

allParmsAndAttrs) ; 

pool , checkln (conn) ; 
return returnCode; 
20 } catch (Exception e) { 

try { 

pool . release (conn) ; 

. } 

catch (ResourceException re) { 
25 System. err .print In (methodName + "Caught 

ResourceException" + re) / 
} 

finally { 

return session ( 

30 pWholesalerAccountld, 

pWholesalerPassword, 
optionalAttributes, 
: count + 1) ; 

} 

35 } 
} 

/** 

* This, method provides information about a specified target. 
40 * Currently, the only supported target is "Protocol". 

* This target tells Describe to return the current protocol version 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTI ES_BEING_RETURNED 
45 Expected Result Property Key(s) Returned: 

ATTR_PROTOCOL 

* </PRExBR> 

* ©param pTarget the parameter value 

* ©return the Wholesale Server Protocol Server response . 

50 * ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 

unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_DESCRIBE 

* ©see NSIWholesaleAPI#PARM_TARGET 

* ©see NSIWholesaleAPI#ATTR_PROTOCOL . 
55 * ©see 

WS PRe spons e# COMMAND J2XECOT 
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*/ 

public WSPResponse describe (String pTarget) 
throws NSIWholesaleException { 

return describe (pTarget , new Properties () , 0) ; 

/**■ 

* This method provides information about a specified target . 

* Currently, the only supported target is "Protocol". 

* This target tells Describe to return the current protocol version 

* <BRxPRE> 

Expected Major Result Code: 

COMMAND_EXECUT I ON_S UC C E ED ED_PRO P E RT I E S_B E I NG_RETURNED 

Expected Result Property Key(s) Returned: 
ATTR_PROTOCOL 

* </PRExBR> 

* ©param pTarget the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command _ 

* ©see NSIWholesaleAPI#COMMAND_DESCRIBE 

* ©see NS I Who 1 e s a 1 e AP I # PARM_TARGET 

* ©see NSIWholesaleAPI#ATTR_PROTOCOL 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* " / . . 

*/ 

public WSPResponse describe (String pTarget, Properties 
optionalAttributes) 

throws NSIWholesaleException { 

return describe (pTarget, optionalAttributes, 0); 

protected WSPResponse describe^ 
String pTarget, 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className +" .describe (String, Properties, 

int) "; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse re turnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout {) ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes); 
allParmsAndAttrs .put (PARMJTARGET, pTarget); 
returnCode = conn . makeRequest (COMMAND_DESCRIBE , 

allParmsAndAttrs); 
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pool. checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. print In (me thodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return describe ( 
pTarget, 

opt ionalAt tributes , 
count + 1 ) ; 

} 



/** 

* This method verifies whether or not a specified domain name is 
available. 

* <BRxPRE> 

Expected Major Result Code: 
C01^4AND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pDomainName the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_VERIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN_NAME 

* ©see NSIWholesaleAPI#COMBO_VERIFY_DOMAIN_NAME 

* ©see NS I Who lesaleAPI# PARM_DOMAI N_NAME 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
*/ 

public WSPResponse verifyDomainName ( 

String pDomainName) 
throws NSIWholesaleException { 
return verif yDomainName ( 
pDomainName, 
new Properties () , 
0); 

} 

/** 

* This method verifies whether or not a specified domain name is . 
available . 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECOTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pDomainName the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit .javaapi .NSIWholesaleException when 
unable to complete command 
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* ©see NSIWholesaleAPl#C0MMAND_VERIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN_NAME 

* ©see NSIWholesaleAPI#COMBO_VERIFYJDOMAINJJAME 

* ©see NSIWholesaleAPI#PARM_DOMAIN_NAME 

5 * ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

public WSPResponse verifyDomainName ( 
String pDomainName, 
10 Properties optionalAttributes) 

throws NSIWholesaleException { 
return verifyDomainName ( 
pDomainName, 
optionalAttributes , 
15 0); 
} 

protected WSPResponse verifyDomainName ( 
String pDomainName, 
Properties optionalAttributes, 
20 int count) 

throws NSIWholesaleException { 

String methodName = className + " .verifyDomainName (String, 
Properties, int) "; 

if (count > retry) { 

25 throw new NSIWholesaleException (methodName + "Unable to 

complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

30 

try { 

conn « (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

35 // put optional attributes 

propertiesCat (allParmsAndAttrs , optionalAttributes) ; 

allParmsAndAttrs. put ( PARM_DOMAIN_NAME , pDomainName) ; 

40 returnCode = conn.makeRequest (COMBO_VERIFY_DOMAIN_NAME, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; , 
return returnCode; 
} catch (Exception e) { 
45 try { 

pool. release (conn) ; 

} 

catch (ResourceException re) { 

Sys tern. err. print In (methodName +. "Caught 
50 ResourceException" + re) ; 

} 

finally { 

return verifyDomainName ( 
pDomainName, 

55 optionalAttributes, 

count + 1) ; 

>-- 
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/** 

* This method verifies if series of domains are available. The command 

* will take the domain target string and add the .com, .net, and .org 

* TLD suffix and verify the domain name availability. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

DomainNamel : 

DomainName2 : 

DomainName3 : 

. . .etc. 

* </PRExBR> 

* ©param pDomainTarget the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale. toolkit .javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_VERIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAINS 

* ©see NSIWholesaleAPI#COMBO_VERIFY_DOMAINS 

* ©see NSI Who 1 e s a 1 e AP I ft P ARM__DOMA IN_TARGET 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED__NO_DATA_BEING__RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse verif yDomains { 

String pDomainTarget) 
throws NSIWholesaleException { 

return verif yDomains ( ; 
pDomainTarget, 
new Properties () , 
0); 

} 

/** 

* This method verifies if series of domains are available. The command 

* will take the domain target string and add the .com, .net, and .org 

* TLD suffix and verify the domain name availability. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING__RETURNED 
Expected Result Property Key(s) Returned: 

DomainNamel: 

DomainName2 : 

DomainName3: 

. . .etc. 

* </PRExBR> 

* ©param pDomainTarget the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_VERIFY 

* ©see NSIWhoiesaleAPI#CLASSJDOMAINS 
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* ©see NSIWholesaleAPI#COMBO_VERIFY_DOMAINS 

* ©see NSIWholesaleAPI#PARM_DOMAIN_TARGET 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see " . 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
*/ 

public WSPResponse verif yDomains ( 
String pDomainTarget , 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return verif yDomains ( 
pDomainTarget, 
optionalAttributes, 
0); 

} 

protected WSPResponse veri f yDomains ( 
String pDomainTarget, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + 11 .verif yDomains (String, 
Properties, int) 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
allParmsAndAttrs. put <PARM_DOMAIN_TARGET, pDomainTarget) ; 
returnCode = conn. makeRequest (COMBO_VERIFY_DOMAINS , 

allParmsAndAttrs) ; 

pool. checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. println (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return verif yDomains ( 
pDomainTarget, 

optionalAttributes, . — 

count + 1) ; 

■ T 
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* This method verifies whether or. not a specified customer account id 

and 

* password are valid. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_Nd - DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit. javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_VERIFY 

* ©see NSIWholesaleAPI#CLASS_PASSWORD 

* ©see NSIWholesaleAPI#COMBO_VERIFY_PASSWORD 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMERJPASSWORD 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

*/ 

public WSPResponse verif yPassword ( 
String pCustomerAccountld, 
String pCustomerPassword) 
throws NSIWholesaleException { 
return verif yPassword ( 

pCustomerAccountld, 
pCustomerPassword, 
new Properties (} , 
0); 

} 

/** 

* This method verifies whether or not a specified customer account id 

and 

* password are valid. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING - RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_VERIFY 

* ©see NSIWholesaleAPI#CLASS_PASSWORD . 

* ©see NSIWholesaleAPI#COMBO_VERIFY_PASSWORD. 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

*/ 

public WSPResponse verif yPassword ( 
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String pCus tomer Account Id , 
String pCustomerPassword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return verifyPassword ( 

pCu s t ome r Ac coun t I d , 

pCustomerPassword, 

optionalAttributes, 

0); 

"J' 

protected WSPResponse verifyPassword ( 
String pCustomerAccountld, 
String pCustomerPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " .verifyPassword (String, String, 
Properties, int) "; 

- if -(count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command" )/ 

} 

NSIWholesaleConnection conn m null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

' : ••" allParmsAndAttrs . put <PARM_CUSTOMER_ACCOUNT_ID, 

pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_PAS SWORD, 
pCustomerPassword) ; 

returnCode = conn. makeRequest (COMBO_VERIFY_P AS SWORD, 

allParmsAndAttrs); 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err .println (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return verifyPassword ( 

pCustomerAccountld, 
pCustomerPassword, 
optionalAttributes, 
count + 1) ; 

._..) •■ 
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} 



/** 

* This method creates an individual customer account and returns an 

* automatically generated customer account id. 

* <BR><PRE> 

Expected Major Result Code: 
C0MMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key{s) 'Returned: 
ATTR_CUSTOMERJVCCOUNT_ID 

* </PRExBR> 

* ©param aFirstName the attribute value 

* ©param aLastName the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aCustomerPas sword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aCity the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NS I Who 1 e sa le AP I # COMMAND__CREATE 

* ©see NSIWholesaleAPIttCLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_CREATE_INDIVIDUAL_ACCOUNT 

* ©see NS I Who 1 e sa 1 e AP I # ATTR_F I RST_NAME 

* ©see NS I Who 1 e sa 1 eAP I # ATTR~LAST_NAME 

* ©see NS I Who 1 e sal eAPI #ATTR~ADDRESS 1 

* ©see NSIWholesaleAPI#ATTRj:OUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSI Who 1 e s a 1 eAP I # ATTR — AUTH_QUEST I ON 

* ©see NS I Who 1 es a 1 eAP I # ATTR_AUTH~ANS WER 

* ©see NSIWholesaleAPI#ATTR_CITY 
* 

* ©see NSIWholesaleAPItfATTR^STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_ADDRESS2 

* ©see NSIWholesaleAPI#ATTR_ADDRESS3 . 

* ©see NS I Who 1 e sa 1 e AP I # ATTR_ADDRESS4 

* ©see NS I Who 1 e sa 1 e AP I # ATTR_ADDRES S 5 

* ©see NS I Who 1 e s a 1 eAP I # ATTR_EMA I L 

* ©see NSIWholesaleAPI#ATTR_FAX 
* 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECOTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 
* 

*/ 

public WSPResponse createlndividualAccount ( 
String aFirstName, 
. String aLastName, . 
String aAddressl, 
String aCountryCode, 
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String aPhone, 
String aCustomer Pas sword, • 
String aAuthQuestion, 
String aAuthAnswer, 
String aCity) 
throws NSIWholesaleException { 

return createlndividualAccount ( 

aFirstName, 

aLastName, 

aAddressl, 

aCountryCode, 

aPhone, 

aCus tomer Password , 
aAuthQuestion, 
aAuthAnswer, 
aCity, 

new Properties ( ) , . 
0) 

} 

/" 

* This method creates an individual customer account and returns an 

* automatically generated customer account id. 

* <BRxPRE> 

Optional Attribute Key(s) : 
ATTR_ADDRESS2 
ATTR — ADDRESS 3 
ATTR_ADDRESS4 
ATTR_ADDRESS5 
ATTR_EMAIL 
ATTR_FAX 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTI ES_BE ING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_CUSTOMER_ACCOUNT_ID 

* </PRExBR> 

* ©param aFirstName the attribute value 

* ©param aLastName the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute . value 

* ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer . the attribute value 

* ©param aCity the attribute value 

* ©param optional At tributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NS I Whol e sal eAP I # COMMAND_CRE ATE 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_CREATE_INDIVIDUAL_ACCOUNT 

* ©see NS I Whol e s a leAP I # ATTR_FI RST_NAME 

* ©see NSIWholesaleAPI#ATTR_LAST_NAME 

* ©see NSIWholesaleAPI#ATTR_ADDRESSl 

* @see_NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 
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* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 

* ©see NS I Who le s a 1 e AP I # ATTR_AUTH_ANS WER 

* ©see NSIWholesaleAPI#ATTR_CITY 
5 * 

* ©see NS I Whol e s a 1 e A P I # ATTR^STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE . 

* ©see NSlWholesaleAPI#ATTR_ADDRESS2 

* ©see NS I Wholesa leAPI # ATTR_ADDRESS3 
10 * ©see NSIWholesaleAPI#ATTR_ADDRESS4 

* ©see NSIWholesaleAPI#ATTR_ADDRESS5 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSIWholesaleAPI#ATTR_FAX 
* 

15 * ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES BEING_RETLJRNED 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 
* 

20 */ 

public WSPResponse createlndividualAccount ( 
String aFirstName, 
String aLastName, 
String aAddressl, 
25 String aCountryCode, . 

String aPhone, 
String aCustomer Pas sword, 
String aAuthQuestion, 
String aAuthAnswer, 
30 String aCity, 

Properties optionalAttributes) 
throws NSlWholesaleException { 

return createlndividualAccount ( 
aFirstName, 
35 aLastName, 

aAddressl, 
aCountryCode, 
aPhone, 

aCustomer Pas sword, 
40 aAuthQuestion, 

aAuthAnswer, 
aCity, 

optionalAttributes, 
0) ; 

45 } 

protected WSPResponse createlndividualAccount ( 

String aFirstName, 

String aLastName, 

String aAddressl, 
50 String aCountryCode, 

String aPhone, 

String aCustomer Pas sword, 

String aAuthQuestion, 

String aAuthAnswer, 
55 String aCity, 

Properties optionalAttributes, 

int count) 
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throws NSIWholesaleException { 

String methodName = className + 
» .createlndividualAccount (StringX9, Properties, int) ,* 
if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command 11 ); 

} 

NSIWholesaleConnection conn « null; 
WSPResponse returnCode; 

try { . .. 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs « new Properties!); 

15 // put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs. put (ATTR_FIRST_NAME, aFirstName) ; 
allParmsAndAttrs. put (ATTR_LAST_NAME, aLastName); 
20 allParmsAndAttrs .put (ATTR_ADDRESS1 , aAddressl) ; 

allParmsAndAttrs . put (ATTR_COUNTRY_CODE, aCountryCode) ; 
allParmsAndAttrs .put (ATTR_PHONE, aPhone) ; 
allParmsAndAttrs .put (ATTR_CUSTOMER_PAS SWORD, 
aCustomerPassword) ; 

25 allParmsAndAttrs . put (ATTR_AUTH_QUESTION , aAuthQuestion) 

allParmsAndAttrs .put (ATTR_AUTH_ANSWER, aAuthAnswer) ; 
allParmsAndAttrs. put (ATTR_CITY, aCity) ; 



30 



returnCode = 

conn .makeRequest (COMBO_CREATE_INDIVIDUAL_ACCOUNT, allParmsAndAttrs) ; 
pool . checkln (conn) ; 
return returnCode; 

} 

catch (Exception e) { 
35 try { 

pool .release (conn) ? 

} 

catch (ResourceException re) { 

System. err .println (methodName + "Caught 
40 ResourceException" + re) ; 

} 

finally { 

return createlndividualAccount ( 
aFirstName, 

45 aLastName, 

aAddressl, 
aCountryCode, 
aPhone, 

aCustomerPassword, 
50 aAuthQuestion, 

. aAuthAnswer, 
aCity, 

optionalAttributes, 
count + 1) ; 

55 } 
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/* * 

* This method creates an individual customer account and returns an 

* automatically generated customer account id. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key{s) Returned: 
ATTR_CUSTOMER_ACCOUNT_ID 

* </PRExBR> 

* ©par am aFirstName the attribute value 

* ©param aLastName the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aCity the attribute value 

* ©param aState the attribute value 

* ©param aPostalCode . the attribute value 

* ©return the wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable , to complete command 

* ©see NSI Who lesaleAPI# COMMAND_CRE ATE 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_CREATE_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#ATTR_FIRST_NAME 

* ©see NSI Who 1 e s a 1 e AP I # ATTR_LAS T_NAM E 

* ©see NSIWholesaleAPI#ATTR_ADDRESSl 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTRJUJTH_QUESTION 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_AUTH_ANS WER 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NS I Who le s a 1 e AP I # ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 
* 

* ©see NSIWholesaleAPI#ATTR_ADDRESS2 

* ©see NSIWholesaleAPI#ATTR_ADDRESS3 

* ©see NSIWholesaleAPI#ATTR_ADDRESS4 

* ©see NSIWholesaleAPI#ATTR_ADDRESS5 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSIWholesaleAPI#ATTR_FAX 
★ 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING — RETURNED 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 
* 

*/ 

public WSPResponse createlndividualAccount ( 
String aFirstName/ 
. String aLastName, 
String aAddressl, 
String aCountryCode, 
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String aPhone, 
String aCustomer Pas sword, 
String aAuthQuestion, 
String aAuthAnswer, 
5 String aCity, x . 

String aState, 
String aPostalCode) 
throws NSIWholesaleException { 

return createlndividualAccount ( 
10 aFirstName, 

. _ aLas tName , 
aAddressl, 
aCountryCode, 
aPhone, 

15 aCustomer Password, 

aAuthQuestion, 
aAuthAnswer, 
aCity, 
aState, 

20 aPostalCode, 

new Properties () , . 
0); 

) 

/** 

25 * This method creates an individual customer account and returns an 

* automatically generated customer account id. 

* <BR><PRE> 

Optional Attribute Key(s) : 
ATTR_ADDRESS2 

30 ATTR_ADDRESS3 

ATTR_ADDRESS4 

ATTR_ADDRESS5 . ~- 

ATTR_EMAIL 

ATTR_FAX 

35 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_CUSTOMER_ACCOUNT_ID 
40 * </PRExBR> 

* ©param aFirstName the attribute value 
' * ©param aLas tName the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 
45 * ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aCity the attribute value 
50 * ©param aState the attribute value 

* ©param aPostalCode the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale. toolkit .javaapi. NSIWholesaleException when 
55 unable to complete command 

* ©see NS I Who 1 e s a le API # COMMAND_CREATE 

* @see"NSIWholesaleAPI#CLASS INDIVIDUAL ACCOUNT 
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* ©see NSIWholesaleAPI#COMBO_CREATE_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPIffATTR_FIRST_NAME 

* ©see NSIWholesaleAPI#ATTR_LAST_NAME 

* ©see NSIWholesaleAPI#ATTR_ADDRlssi 

* ©see NSIWholesaleAPI#ATTR~COUNTRY_CODE 

* ©see NS I Whole sale API # ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR~CUST0MER_PASSWORD 

* ©see NSIWholesaleAPI#ATTRJUJTH_QUESTION 

* ©see NS I Whole sale API #ATTR__AUTH_ANSWER 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NS I Who 1 e s a 1 eAP I # ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 
* 

* ©see NSIWholesaleAPI#ATTR_ADDRESS2 

* ©see NSIWholesaleAPI#ATTR__ADDRESS3 

* ©see NSIWholesaleAPI#ATTR_ADDRESS4 

* ©see NSIWholesaleAPI#ATTR~ADDRESS5 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSIWholesaleAPI#ATTR_FAX 
* 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR__CUSTOMER_ACCOUNT_ID 
* 

*/ 

public WSPResponse createlndividualAccount ( 
String aFirstName, 
String aLastName, 
String aAddressl, 
String aCountryCode, 
String aPhone, 
String aCustomerPassword, 
String aAuthQuestion, 
String aAuthAnswer, 
String aCity, 
String aState, 
String aPostalCode, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return createlndividualAccount ( 

aFirstName, 

aLastName, 

aAddressl, 

aCountryCode, 

aPhone, 

aCustomerPassword, 

aAuthQuestion, 

aAuthAnswer, 

aCity, 

aState, 

aPostalCode,. 

optionalAttributes, 

0) ;. 

} 

protected WSPResponse createlndividualAccount ( 
String aFirstName, 
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String aLastName, 
• String aAddressl, 

String aCountryCode, 

String aPhone, 

String aCustomer Pas sword, 

String aAuthQuestion, 

String aAuthAnswer, 

String aCity, 

String aState, 

String aPostalCode, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName = className + 
" .createlndividualAccount (StringXll, Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ; 
Properties allParmsAndAttrs ■ new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (ATTR_FIRST_NAME, aFirstName) ; 
. allParmsAndAttrs .put (ATTR_LAST_NAME, aLastName); 
allParmsAndAttrs . put ( ATTR_ADDRES S 1 , aAddressl) ; 
allParmsAndAttrs . put ( ATTR_COUNTRY_CODE , aCountryCode) ; 
allParmsAndAttrs. put (ATTR_PHONE, a Phone ) ; 
allParmsAndAttrs .put (ATTR_CUS TOME REPASS WORD, 
aCustomer Pas sword) ; 

allParmsAndAttrs. put (ATTR_AUTH_QUESTION, aAuthQuestion) ; 
allParmsAndAttrs. put (ATTR_AUTH_ANSWER, aAuthAnswer); 
allParmsAndAttrs. put (ATTR_CITY, aCity) ; 
allParmsAndAttrs. put (ATTR_STATE, aState) ; 
allParmsAndAttrs . put (ATTR_POSTAL_CODE, aPostalCode) ; 

returnCode = 

conn .makeRequest (COMBO_CREATE_INDIVIDUAL_ACCOUNT, allParmsAndAttrs) ; 
pool . checkln (conn) ; 
return returnCode; 

) 

catch (Exception e) { 
try { 

pool .release (conn) ; 

. }...■■■ 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

) 

finally { 

return createlndividualAccount ( 
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aFirstName, 

aLastName, 

aAddressl, 

aCountryCode, 

aPhone, 

aCustomerPassword, 

aAuthQuestion, 

aAuthAnswer, 

aCity, 

aState, 

aPostalCode, 

optionalAttributes, 

count + 1) ; 



/** 

* This method creates a business customer account and returns an 

* automatically generated customer account id. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_CUSTOMER_ACCOUNT_ID 

* </PRExBR> 

* ©param aCompanyName the attribute value 

* ©param aCompanyType the attribute value 

* ©param aAddressl the attribute value 

* ©param aCity the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aCustomer Password the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aLegalContactFirstName the attribute value 

* ©param aLegalContactLastName the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception, nsi .wholesale . toolkit . javaapi .NS I WholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_CREATE 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO~CREATE_BUSINESS_ACCOUNT 

* ©see NS I Who lesaleAPI # ATTR_COM PANY_NAME 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_COM PANY_T Y PE 

* ©see NSI Whole sale API #ATTR_ADDRESS1 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_AUTH__QUESTION. 

* ©see NS I Who 1 e s a 1 eAP I # ATTR_AUTH_ANS WER 

* ©see NS I Who lesaleAPI # ATTR_LEGAL_CONTACT_F I RS T_NAM E 

* ©see NS I WholesaleAPI #ATTR_LEGAL_CONTACT_LAST_NAME 

* . • 

* ©see NSIWholesaleAPI#ATTR_STATE 
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* 


©see 




©see 
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©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 


* 


©see 




©see 


* 


©see 




©see 


* 


©see 


* 


©see 


★ 


©see 




©see 




©see 


* 


©see 


* 


©see 


* 


©see 


* 




* 


©see 


* 


©see 



10 



15 



20 



WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_CUSTOMERJVCCOUNT_ID 

25 

*/ 

public WSPResponse createBusinessAccount ( 
String aCompanyName , 
String aCompanyType , 
30 String aAddressl, 

String aCity, _ 
String aCountryCode, 
String aPhone, 
String aCustomerPassword, 
35 String aAuthQuestion, 

String aAuthAnswer, 
String aLegalContactFirstName, 
String aLegalContactLastName) 
throws NSlWholesaleException { 
40 return createBusinessAccount ( 

aCompanyName , 
aCompanyType, 
aAddressl, 
aCity, 

45 aCountryCode, 

aPhone, ■ 

aCustomerPassword, 

aAuthQuestion, 

aAuthAnswer, 

50 aLegalContactFirstName, 

aLegalContactLastName, 
new Properties () , 
0); 

} 

55 /** 

*.„This method creates a business customer account and returns an 

* automatically generated customer account id. 
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* <BRxPRE> 

Optional Attribute Key(s) : 
ATTR_ADDRESS2 
ATTR_ADDRESS3 
ATTR_ADDRESS4 
ATTR — ADDRESS 5 
ATTR_EMAIL 
ATTR_FAX 

ATTR_LEGAL_CONTACT_ADDRESS 1 

ATTR_LEGAL_CONTACT^ADDRESS2 

ATTR_LEGAL~CONTACT_ADDRESS 3 

ATTR_LEGAL_CONTACT_ADDRESS4 

ATTR_LEGA!i"C0NTACT_ADDRESS 5 

ATTRJLEGAL_CONTACT_CITY 

ATTR_LEGAL_CONTACT_STATE 

ATTR_LEGAL_CONTACT_POSTAL_CODE 

ATTR_LEGAL_CONTACT_COUNTRY_CODE 

ATTR_LEGAL_CONTACT_PHONE 

ATTR_LEGAL_CONTACT_FAX 

ATTR_LEGAL_CONTACT_EMAIL 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_CUSTOMER_ACC0UNT_ID 

* </PRExBR> 

* ©param aCompanyName the attribute value 

* ©param aCompanyType the attribute value 

* ©param aAddressl the attribute value 

* ©param aCity the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aLegalContactFirstName the attribute value 

* ©param aLegal Contact La stName the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPItfCOMMAND^CREATE 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMB0_CREATE_BUSINESS_ACC0UNT 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_COM P ANY_NAM E 

* ©see NS I Whole sale API #ATTR_COMPANY_TYPE 

* ©see NSIWholesaleAPI#ATTR_ADDRESSl 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_AUTH__QUESTION 

* ©see NSIWholesaleAPI#ATTR_AUTH_ANSWER 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_FIRST_NAME 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_LAST_NAME 

*"~@see NSIWholesaleAPI#ATTR_STATE 
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* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_ADDRESS2 

* ©see NSIWholesaleAPI#ATTR_ADDRESS3 

* ©see NSIWholesaleAPI#ATTR_ADDRESS4 
5 * ©see NSIWholesaleAPI#ATTR_ADDRESS5 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSlWholesaleAPI#ATTR_FAX 

* ©see NSIWholesaleAPI#ATTRJ^EGAL_CONTACT_ADDRESSl 

* ©see NS I Whol e sal e AP I # ATTR_LEGAL_CONTACT_ADDRES S 2 
10 * ©see NS I Who lesaleAPItf ATTR_LEGAL_CONTACT_ADDRE S S 3 

* ©see. NSIWholesaleAPI#ATTR_LEGAL_CONTACT_ADDRESS4 

* ©see NS I Whol e sa 1 e AP I # ATTR_LEGAL_CONTACT_ADDRESS 5 

* ©see NS I Whol esaleAPI # ATTR_L EGAL_CONTACT_C I T Y 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_STATE 
15 * ©see NSIWholesaleAPI#ATTR~LEGAL_CONTACT_POSTAL_CODE 

* ©see NS I Whol e s al e API # ATTR_LEGAL_CONTACT_COUNTR Y_CODE 

* ©see NS I Who 1 e S ale AP I # ATTR_LEGAL_CONTACT_PHONE 

* ©see NS I Who le s al e AP I # ATTR_LEGAL_CONTACT_FAX 

* ©see NSIWholesaleAPItfATTR LEGAL CONTACT EMAIL 
20 * " 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR CUSTOMER ACCOUNT ID 
25 * ■ ■ " 

*/ 

public WSPResponse createBusinessAccount ( 
String aCompanyName , 
String aCompanyType , 
30 String aAddressl, 

String aCity, 
String aCountryCode, 
String aPhone,- : ■■ 

String aCustomerPassword, 
35 String aAuthQuestion, 

String aAuthAnswer, 
String aLegalContactFirstName, 
String aLegalContactLastName, 
Properties optionalAttributes) 
40 throws NSIWholesaleException { 

return createBusinessAccount ( 
aCompanyName, 
aCompanyType , 
aAddressl, 
45 aCity, 

aCountryCode, 
aPhone , 

aCustomer Pas sword, 
aAuthQuestion, 
50 aAuthAnswer, 

aLegalContactFirstName, 
aLegalContactLastName, 
optionalAttributes, 
0); 

55 } 

protected WSPResponse createBusinessAccount ( 
String aCompanyName # 
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String aCompanyType, 
String aAddressl, 
String aCity, 
String aCountryCode> 
5 String aPhone, 

String aCustomerPassword, 
String aAuthQuestion, 
String aAuthAnswer,. 
String aLegalContactFirstName , 
10 String aLega icon tact Las tName, 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " . createBusinessAccount (StringXll , 
15 Properties, int) "; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

20 NSIWholesaleConnection conn » null; 

WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
25 Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes); 

30 allParmsAndAttrs .put (ATTR_COMPANY_NAME, aCompanyName) ; 

allParmsAndAttrs .put (ATTR_COMPANY_TYPE, aCompanyType ) ; 
allParmsAndAttrs. put (ATTR^ADDRESSl , aAddressl); 
allParmsAndAttrs. put (ATTR_CITY, aCity) ; 
allParmsAndAttrs. put (ATTR^COUNTRY^CODE, aCountryCode) ; 
35 allParmsAndAttrs .put (ATTR_PHONE, aPhone) ; 

allParmsAndAttrs .put (ATTR_CUSTOMER_PAS SWORD, 
aCustomerPassword); 

allParmsAndAttrs .put (ATTR_AUTH_QUESTION, aAuthQuestion); 
allParmsAndAttrs .put (ATTR_AUTH_ANSWER, aAuthAnswer) ; 
40 allParmsAndAttrs . put (ATTR_LEGAL_CONTACT_FIRST_NAME, 

aLegalContactFirstName); 

al lParmsAndAttrs . put ( ATTR_LEGAL_CONTACT_LAST_NAME , 
aLegalContactLastName) ; 

45 returnCode = conn. make Re quest (COMBO_CRE ATE_BUS I NESS_ACCOUNT, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
50 try { 

pool. release (conn) ; 

} . . 

catch (ResourceException re) { 

System. err. println (methodName + "Caught 
55 ResourceException" + re) ; 

• } 

" finally { . 
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return createBusinessAccount { 
aCompanyName , 
aCompanyType , 
aAddressl, 

5 aCity, 

aCountryCode, 
aPhone, 

aCustomer Pas sword, 
aAuthQuestion, 
10 aAuthAnswer, 

aLegalContactFirstName , 
aLegalContactLastName , 
optionalAttributes , 
count + l ) ; 

15 \ . 



20 * This method creates a business customer account and returns an 

* automatically generated customer account id. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
25 Expected Result Property Key(s) Returned: 

ATTR_CUSTOMER_ACCOUNT_ID 

* </PRExBR> " 

* ©param aCompanyName the attribute value 

* ©param aCompanyType the attribute value 
30 * ©param aAddressl the attribute value 

* ©param aCity the attribute value 

* ©param aState the attribute value - 

* ©param aPostalCode the attribute value 

* ©param aCountryCode the attribute value 
35 * ©param aPhone the attribute value 

* ©param aCustomer Pas sword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aLegalContactFirstName the attribute value 
40 * ©param aLegalContactLastName the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale. toolkit. javaapi . NSIWholesaleException when 
unable to complete command 

45 



50 



55 



. * 
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* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_FIRST_NAME 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_LAST_NAME 
* 

* ©see NS I who 1 e sa 1 eAP I # ATTR_ADDRESS 2 

* ©see NS I Whol esa leAPl # ATTR_ADDRESS 3 

* ©see NSIWholesaleAPI#ATTR_ADDRESS4 

* ©see NSIWholesaleAPI#ATTR_ADDRESS5 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSIWholesaleAPI#ATTR~FAX 

* ©see NSIWholesaleAPI#ATTR_LEGAL 

* ©see NSIWholesaleAPI#ATTR_LEGAL 

* ©see NS IWholesaleAPI #ATTR_LEGAL* 

* ©see NSIWholesaleAPI#ATTR_LEGAL 

* ©see NS I Whol es a 1 eAP I # ATTR_LEGAL~ 

* ©see NSIWholesaleAPI#ATTR_LEGAL 

* ©see NSIWholesaleAPI#ATTR_LEGAL~ 

* ©see NS I Who 1 e s a 1 eAP I # ATTR_LEG Al/ 

* ©see NSIWholesaleAPI#ATTR~LEGAL 

* ©see NSIWholesaleAPI#ATTR_LEGAL~ 

* ©see NSIWholesaleAPI#ATTR_LEGAL~ 

* ©see NS IWholesaleAPI #ATTR_LEGAl/ 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 
* 

public WSPResponse createBusinessAccount { 
String aCompanyName, 
String aCompanyType , 
String aAddressl, 
String aCity, 
String aCountryCode, 
String aPhone, 
String aCustomerPassword, 
String aAuthQuestion, 
String aAuthAnswer, 
String aLegalContactFirstName, 
String aLegalContactLastName, 
String aState, 
String aPostalCode) 
throws NSIWholesaleException { 

return createBusinessAccount ( 

aCompanyName, 

aCompanyType, 

aAddressl, 

aCity, 

aCountryCode, 
aPhone, 

aCustomer Pas sword, 
aAuthQuestion, 
aAuthAnswer, 
aLegalContac tFirstName , 
aLegalContactLastName, 

aState, 

aPostalCode, 



CONTACT_ADDRESS 1 

CONTACT_ADDRESS2 

*CONTACT_ADDRESS 3 

"C0NTACT_ADDRESS4 

*CONTACT_ADDRESS 5 

*CONTACT_CITY 

CONT ACT_S TATE 

C0NTACT_P0STAL_CODE 

CONTACT_COUNTRY_CODE 

CONTACT_PHONE 

CONTACT_FAX 

CONTACT EMAIL 
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new Properties () , 

0); • 

} 

I * * 

* This method creates a business customer account and returns an 

* automatically generated customer account id. 

* <BRxPRE> 

Optional Attribute Key(s) : 
ATTR_ADDRESS2 
* ATTR_ADDRESS3 
ATTR_ADDRESS4 
ATTR_ADDRESS5 
ATTR~EMAIL 
ATTR_FAX 

attr_legal_contact_address 1 

attr2legal_contact_address2 

attr_leg al_contact_addres s 3 

attr_legal_contact_address4 

attrjlegal_contact_address5 

attr~legalj:ontact_city 

attr_legaljx>ntact_state 

attrjlegal_contact_postal_code 

attr_legal_cootact_country_code 

attr_legal_contact_phone 

attr_legal_contact_fax 

attr_legal_contact_email 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_CUST0MER_ACC0UNT_ID . 

* </PRExBR> 

* ©param aCOmpanyName the attribute value 

* ©param aCompanyType the attribute value 

* ©param aAddressl the attribute value 

* ©param aCity the attribute value 

* ©param aState the attribute value 

* ©param aPostalCode the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aCustomerPassword the attribute value 

* ©param aAuthQuestion the attribute value 

* ©param aAuthAnswer the attribute value 

* ©param aLegalContactFirstName the attribute value 

* ©param aLegalContactLastName the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_CREATE 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_CREATE_BUSINESS_ACCOUNT 

* ©see NSI Who lesaleAPI # ATTR_COM PANY^NAME 

* ©see NSIWholesaleAPI#ATTR_COMPANY~TYPE 

* ©see NSIWholesaleAPI#ATTR_ADDRESSl 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI#ATTR_STATE 
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aCUs tome r Pa s sword , 

aAuthQuestion, 

aAuthAnswer, 

aLegalContactFirstName, . 

aLegalContactLastName , 

aState, 

aPostalCode, 

optionalAttributes, 

0) ; 

} 

protected WSPResponse createBusinessAccount ( 

String aCompanyName , 

String aCompanyType, 

String aAddressl, 

String aCity, 

String aCountryCode, 

String aPhone, 

String aCustomerPassword, 

String aAuthQuestion, 

String aAuthAnswer, 

String aLegalContactFirstName, 

String aLegalContactLastName, 

String aState, 

String aPostalCode, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName » className + " . createBusinessAccount (StringX13 , 
Properties, int) "; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); . 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes); 

allParmsAndAttrs. put (ATTR_COMPANY_NAME, aCompanyName); 

allParmsAndAttrs . put ( ATTR_COMPANY_TYPE , aCompanyType ) ; 

allParmsAndAttrs. put (ATTR_ADDRESS1, aAddressl); 

allParmsAndAttrs. put (ATTR_CITY, aCity) ; 

allParmsAndAttrs. put (ATTR_COUNTRY_CODE, aCountryCode) ; 

allParmsAndAttrs. put (ATTR_PHONE, a Phone ) ; . . 

allParmsAndAttrs .put ( ATTR_CUS TOME R_PASS WORD, 
aCustomerPassword) ; 

allParmsAndAttrs. put (ATTR_AUTH_QUESTION / aAuthQuestion); 

allParmsAndAttrs. put (ATTR_AUTH_ANSWER, aAuthAnswer); 

allParmsAndAttrs .put (ATTR_LEGAL_CONTACT_FIRST_NAME, 
aLegalContactFirstName); 

._. allParmsAndAttrs . put (ATTR_LEGAL_CONTACT_LAST_NAME , 

aLegalContactLastName); 



* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR~CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 

* ©see NS I Who 1 e s a 1 e A P I # ATTR_AUTH~ANS W E R 

* ©see NS I Who 1 e s a 1 e A P I # ATTR_LEGAL_CONTACT_F I RS T_NAM E 

* ©see NSIWholesaleAPI#ATTR~LEGAL_CONTACT_LAST_NAME 
* 

* ©see NSIWholesaleAPI#ATTR_ADDRESS2 
*. ©see NSIWholesaleAPI#ATTR~ADDRESS3 

* ©see NSIWholesaleAPI#ATTR_ADDRESS4 

* ©see NSIWholesaleAPI#ATTR_ADDRESS5 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSIWholesaleAPI#ATTR~FAX 

* ©see NS I Whol es a 1 eAPI #ATTR_LEGAL_CONTACT_ADDRESS 1 

* ©see NSIWholesaleAPI#ATTR_LEGAL_C0NTACT_ADDRESS2 

* ©see NS I Whol e sal e AP I # ATTR_LEGAL_CONTACT_ADDRES S 3 

* ©see NSIWholesaleAPI#ATTR_LEGAL_C0NTACT_ADDRESS4 

* ©see NS I Whol es a 1 eAPI #ATTR_LEGAL_CONTACT__ADDRESS 5 

* ©see NS I Who 1 e s a 1 e A P I # ATTR_LEG AL_CONTACT_C I T Y 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_LEGAL_CONTACT_STATE 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_COUNTRY_CODE 

* ©see NS I Whol e sal eAPI # ATTR_LEGAL__CONTACT__PHONE 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_FAX 

* ©see NS IWhol e sa 1 eAPI #ATTR_LEGAL_CONTACT_EMAI L 

* , 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTI0N_SUCCEEDED_PR0PERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_ACCOUNT_ID 

; * 

*/ 

public WSPResponse createBusinessAccount ( 
String aCompanyName, 
String aCompanyType , 
String aAddressl, 
String aCity, 
String aCountryCode, 
String aPhone, 
String aCustomer Pas sword, 
String aAuthQuestion, 
String aAuthAnswer, 
String aLegalContactFirstName, 
String aLegalContactLastName, 
String aState, 
String aPostalCode, 
Properties optionalAttributes) 
throws NSIWhblesaleException { 

return createBusinessAccount ( 

aCompanyName, 

aCompanyType, 

aAddressl, 

aCity, 

aCoun try Code, 
aPhone, 
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allParmsAndAttrs .put (ATTR_STATE, aState); 
allParmsAndAttrs. put (ATTR_POSTAL_CODE, aPostalCode); 

returnCode = conn. makeRequest (COMBO j:REATE_BUS I NESS_ACCOUNT, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return createBusinessAccount ( 
aCompanyName, 
aCompanyType , 
aAddressl, 
aCity, 

aCountryCode, 
. a Phone, 
aCu s tome r Pa s s wo r d , 
aAuthQuestion, 
aAuthAnswer, 
aLegalContactFirstName, 
aLegalContactLastName, 
aState, 
aPostalCode, 
optionalAttributes , 
count + 1) ; 

■ } • 

} 

} 



/** 

* This method creates a technical contact and returns an 

* automatically generated technical contact id (NIC Handle) . 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED — PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTRJTECH_CONTACT_ID 

* </PRExBR> 

* ©param aFirstName the attribute value 

* ©param aLastName the attribute value 

* ©param aOrganization the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aEmail the attribute value 

* ©param aTechContactPassword the attribute value 
. * ©param aCity the attribute value 

* ©return the Wholesale Server Protocol Server response 
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* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NS I Who 1 es a 1 e AP I # COMMAND_CRE ATE 

* ©see NSIWholesaleAPI#CLASS_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#COMBO_CREATE_TECHNICAL_CONTACT 

* ©see NS I Whole sa 1 eAPI # ATTR_FI RST_NAME 

* ©see NS IWholesaleAPI #ATTR_LAST_NAME 

* ©see NS I Who 1 e s a 1 eAP I # ATTR_ORGAN 1 2 AT ION 

* ©see NSIWholesaleAPI#ATTR~ADDRESSl 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 
©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_ClTY 
* 

* ©see NSlWholesaleAPI#ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_FAX 
* 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND - EXECUTION_SUCCEEDED_PR0PERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

*/ 

public WSPResponse createTechnicalContact ( 
String aFirstName, 
String aLastName, 
String aOrganization, 
String aAddressl, 
String aCountryCode , 
String aPhone, 
String aEmail, 

String aTechContactPassword, 
String aCity) 
throws NSIWholesaleException { 

return createTechnicalContact ( 

aFirstName, 

aLastName, 

aOrganization, 

aAddressl, 

aCountryCode, 

aPhone, 

aEmail, 

aTechContactPassword, 
aCity, . 

new Properties () , 
0); 

} 

/** 

* This method creates a technical contact and returns an 

* automatically generated technical contact id (NIC Handle). 

* <BRxPRE> 

Optional Attribute Key(s) : 
ATTR FAX 
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Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING — RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_TECH_CONTACT_I D 

* </PRExBR> 

* ©param aPirstName the attribute value 

* ©param aLastName the attribute value 

* ©param aOrganization the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 
( .... * ©param aPhone the attribute value 

* ©param aEmail the attribute value 

* ©param aTechCon tact Password the attribute value 

* ©param aCity the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit. javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NS I Whol e s a 1 e AP I #COMMAND_CRE ATE 

* ©see NSIWholesaleAPI#CLASSJTECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#COMBO^CREATE_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#ATTR_FIRST_NAME 

* ©see NS I Whol e sal eAP I # ATTR_LAST_NAME 

* ©see NS I Who 1 e s a 1 eA P I # ATTR_ORGANI Z AT I ON 

* ©see NS I Who 1 e s a leAP I # ATTR_ADDRES S 1 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_CITY 
* 

* ©see NSIWholesaleAPI#ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_FAX 
* 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#C0MMAND_EXECUTION_SUCCEEDED_PR0PERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 
* 

*/ 

public WSPResponse createTechnicalContact { 
String aFirstName, 
String aLastName, 
String aOrganization, 
String aAddressl, . . 

String aCountryCode, 
String aPhone, 
String aEmail, 

String aTechContact Password, 
String aCity, 

Properties optionalAttributes) 
throws NSIWholesaleException { 

return createTechnicalContact ( 
aFirstName, 

aLastName, 

aOrganization, 
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aAddressl, 
aCountryCode, 
aPhone, 
aEmail, 

aTechContact Password, 
aCity, 

optionalAttributes, 
0); 

} 

protected WSPResponse createTechnicalContact ( 
String aFirstName, 
String aLastName, 
String aOrganization, 
String aAddressl, 
String aCountryCode, 
String aPhone, 
String aEmail, 

String aTechCont act Pas sword, 
String aCity, 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + ". createTechnicalContact <StringX9, 
Properties, int) "; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; • 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes); 

allParmsAndAttrs .put (ATTR_FIRST_NAME, aFirstName); 
allParmsAndAttrs . put (ATTR_LAST_NAME , aLastName) ; 
allParmsAndAttrs .put ( ATTR_ORGANI Z AT ION , aOrganization) ; 
allParmsAndAttrs. put (ATTR_ADDRESS1, aAddressl); 
allParmsAndAttrs. put (ATTR_COUNTRY_CODE, aCountryCode); 
allParmsAndAttrs .put (ATTR_PHONE, aPhone); 
allParmsAndAttrs .put (ATTR_EMAIL, aEmail); 
allParmsAndAttrs . put (ATTR_TECH_CONTACT_PASSWORD, 
aTechContactPassword) ; 

allParmsAndAttrs. put (ATTR_CITY, aCity) ; 

returnCode = 

conn.makeRequest ( COMBO_CREATE_TECHNICAL_CONTACT , allParmsAndAttrs) ; 
pool .checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool. release (conn) ; 
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catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return createTechnicalContact ( 
aFirstName, 
aLastName, 
aOrganization, 
aAddressl, 
aCountryCode, 
aPhone, 
aEmail, 

aTechContact Password, 
aCity, 

optionalAttributes, 
count + 1) ; 

} 

} . 

} 

/** 

* This method creates a technical contact and returns an 

* automatically generated technical contact id (NIC Handle) . 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key (s) Returned: 
ATTR_TECH_CONTACT_ID 

* </PRExBR> 

* ©param aFirstName the attribute value 

* ©param aLastName the attribute value 

* ©param aOrganization the attribute, value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aEmail the attribute value 

* ©param aTechContactPassword the attribute value 

* ©param aCity the attribute value 

* ©param aState the attribute value 

* ©param aPostalCode the attribute value 

* ©return the Wholesale Server Protocol Server response 

. * .©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_CREATE 

* ©see NSIWholesaleAPI#CLASS_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#C0MB02cREATE_TECHNICAL_C0NTACT 

* ©see NSIWholesaleAPI#ATTR_FIRST_NAME 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_LAST_NAME 

* ©see NSIWholesaleAPI#ATTR_ORGANIZATION 

* ©see NSIWholesaleAPI#ATTR_ADDRESSl 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_PASSWORD 
' * ©see NSIWholesaleAPI#ATTR_CITY 

"■'..* ©see NSIWholesaleAPI#ATTR_STATE 
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* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

• * 

* ©see NSIWholesaleAPI#ATTR_FAX 
* 

* ©see WSPResponsettlNVALI DEVALUE 

* ©see 

WSPResponse#COMMAND - EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

public WSPResponse createTechnicalContact ( 
String aFirstName, 
String aLastName, 
String ^Organization, 
String aAddressl, 
String aCountryCode, 
String aPhone, 
String aEmail, 

String aTechContactPassword, 
String aCity, 
String aState, 
String aPostalCode) 
throws NSIWholesaleException { 

return createTechnicalContact ( 

aFirstName, 

aLastName, 

aOrganization, 

aAddressl, 

aCountryCode, 

aPhone, 

aEmail, 

aTechCon t ac t Pa s sword , 

aCity, 

aState, 

aPostalCode, 

new Properties () , 

0); 

} 

/** 

* This, method creates a technical contact and returns an 

* automatically generated technical contact id (NIC Handle) 

* <BRxPRE> 

Optional Attribute Key(s) : 
ATTR__FAX 

Expected Major Result Code: 
COMMA^_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_TECH_CONTACT_I D 

* </PRExBR> 

. * ©param aFirstName the attribute value 

* ©param aLastName the attribute value 

* ©param aOrganization the attribute value 

* ©param aAddressl the attribute value 

* ©param aCountryCode the attribute value 

* ©param aPhone the attribute value 

* ©param aEmail the attribute value 



WO 01/20484 



PCTYUS00/25305 



* ©param aTechContact Pas sword the attribute value 

* ©param aCity the attribute value 

* ©param aState the attribute value 

* ©param aPostalCode the attribute value 

. * ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

NSIWholesaleAPI#COMMAND CREATE 
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_STATE 

"postal CODE 



©see WSPResponse#INVALID_VALUE 
©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 
*/ 

public WSPResponse createTechnicalContact ( 
String aFirstName, 
String aLastName, 
String aOrganization, 
String aAddressl, 
String aCountryCode , ' . 
String aPhone, 
. String aEmail, 

String aTechContact Pas sword, 
String aCity, 
String aState, 
String aPostalCode, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return createTechnicalContact ( 

aFirstName, 

aLastName, .. 

aOrganization, 

aAddressl , 

aCountryCode, 

a Phone, 

aEmail, 

aTechContac tPassword , 

aCity, 

aState, 

aPostalCode, 
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opt ionalAt tributes, 
0); 

} 

protected WSPResponse createTechnicalContact ( 
String aFirstName, 
String aLastName, 
String aOrganization, " 
String aAddressl, 
String aCountryCode, 
String' aPhone, . 
String aEmail, 

String aTechContact Password, 

String aCity, 

String aState, 

String aPostalCode, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName = className + 
" .createTechnicalContact (StringXll, Properties, int) M ; 

if (count > retry) { 

throw" new NSIWholesaleException (methodName + "Unable to 
complete command" ); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes); 

allParmsAndAttrs .put (ATTR_FIRST__NAME, aFirstName) ; 
allParmsAndAttrs. put (ATTR_LAST_NAME, aLastName); 
allParmsAndAttrs .put ( ATTR_ORGAN I Z AT I ON , aOrganization) ; 
allParmsAndAttrs. put (ATTR_ADDRESS1 , aAddressl); 
allParmsAndAttrs . put (ATTR_COUNTRY_CODE , aCountryCode) ; 
allParmsAndAttrs. put (ATTR_PHONE, aPhone) ; 
allParmsAndAttrs. put (ATTR_EMAIL, aEmail); 
allParmsAndAttrs . put (ATTR_TECH_CONTACT_PAS SWORD , 
aTechContactPassword) ; 

allParmsAndAttrs. put (ATTR_CITY, aCity) ; 
allParmsAndAttrs. put (ATTR_STATE, aState); 
allParmsAndAttrs. put (ATTRJ?OSTAL_CODE, aPostalCode); 

returnCode = 

conn.makeRequest (COMBO_CREATEJTECHNICAL_CONTACT, allParmsAndAttrs) ; 
pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool. release (conn) ; 

> 

catch (ResourceExcept ion re) { 
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System. err. println (methodName + "Caught 
ResourceException" + re); 

) 

finally { 

5 return createTechnicalContact ( 

aFirstName, 
aLastName, 
aOrganization, 
aAddressl, 

10 aCountryCode, 

aPhone, 
aEmail, 

aTechContactPassword, 
aCity, 

15 aState, 

aPostalCode, 
optionalAttributes, 
count + 1) ; 

20 } * . 

} 

/** 

25 * This method registers a new domain product for an existing 

* customer account. This request assumes that the domain 

* name will be hosted by some organization other than 

* Network Solutions. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

30 * COM^4AND_EXECUTION_SUCCEEDED_PROPERTIES - BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
C0MMAND_EXECUTION_SUCCEEDED_PR0PERTIES_BEING_RETURNED 
35 Expected Result Property Key(s) Returned: 

ATTR_ISP_ PAS SWORD 

* </PRExBR> 

* ©param pCustomerAc count Id. the parameter value 

* ©param pCustomerPassword the parameter value 
40 * ©param aDomainName the attribute value 

* ©param aHostNamel the attribute value 

* ©param aHostAddrl the attribute value 

* ©param aHostName2 the attribute value 

* ©param aHostAddr2 the attribute value 

45 * ©param aTechContactld the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception, nsi. wholesale, toolkit, javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSI Whole sale API #COMMAND_CREATE 
50 * ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_CREATE_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NS I Who lesaleAPI # ATTR_DOMA I N_NAME 
55 * ©see NSIWholesaleAPI#ATTR_HOST_NAMEl 

* ©see NS I Who 1 e s a 1 eAP I # ATTR_HOST_ADDR 1 

* ©see NSIWholesaleAPI#ATTR HOST NAME2 
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* ©see NSIWholesaleAPI#ATTR_HOST_ADDR2 

* ©see NSIWholesaleAPI#ATTRJTECHj:ONTACT_ID 

* ■ 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#GENERAL_ACCESSJDENIED ~ 

* ©see WSPResponse#INVALID~VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_ISP_PASSWORD 
* 

*/ 

public WSPResponse createDomain ( 
String pCustomerAccountld, 
String pCus tome r Pas sword, 
String aDomainName, 
String aHostNamel, 
String aHostAddrl, 
String aHostName2, 
String aHostAddr2, 
String aTechContactld 
) 

throws NSIWholesaleException { 
return createDomain ( 

pCustomerAccountld, 

pCustomerPassword, 

aDomainName, 

aHostNamel, 

aHostAddrl, 

aHostName2, 

aHostAddr2, 

aTechContactld, 

new Properties {) , 

0); 

} 

/** 

* This method registers a new domain product for an existing 

* customer account. This request assumes that the domain 

* name will be hosted by some organization other than 

* Network Solutions. 

* <BR>NOTE; This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING__RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_I S P_PAS SWORD 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param aDomainName the attribute value 

* ©param aHostNamel the attribute value 

* ©param aHostAddrl the attribute value 

* ©param aHostName2 the attribute value 

* ©param aHostAddr2 the attribute value 

* ©param aTechContactld the attribute value 

* ©param opt ionalAt tributes a property list of optional attributes 
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* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit .javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NS I Who lesaleAPI# COMMAND_CREATE 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_CREATE_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUST0MER_ACCOUNT_ID 
. * ©see NSIWholesaleAPI#PARM~CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR~DOMAIN_NAME 

* ©see NS I Whol e sa 1 eAPI # ATTR_HOST_NAME 1 

* ©see NS I Whol e sa 1 eAP I # ATTR_HOST_ADDR 1 
■* ©see NS I Who 1 e s a 1 eAP I # ATTR_HOST_NAME 2 

* ©see NS I Who lesaleAPI # ATTR_HOS T_AD DR 2 

* ©see NSIWholesaleAPI#ATTRJTECHj:ONTACT_ID 
* 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#GENERAL~ACCESS_DENIED ~ 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR__ISP_PASSWORD 
* 

*/ 

public WSPResponse createDomain ( 
String pCustomerAccountld, 
String pCustomerPassword, 
String aDomainName, 
String aHostNamel, 
String aHostAddrl, 
String aHostName2, 
String aHostAddr2, 
String aTechContactld, 
Properties :optionalAttributes) 
throws NSIWholesaleException { 
return createDomain ( 

pCustomerAccountld, 

pCustomerPassword, 

aDomainName, 

aHostNamel, 

aHostAddrl, 

aHostName2, 

aHostAddr2, 

aTechContactld, 

optionalAttributes , 

0); 

) 

protected WSPResponse createDomain { 
String pCustomerAccountld, 
String pCustomerPassword, 
String aDomainName, 
String aHostNamel, 
String aHostAddrl, 
String aHostName2, 
String aHostAddr2, 
String aTechContactld, 
Properties optionalAttributes, 
int count) 
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throws NSIWholesaleException { 
int rc; 

String methodName = className + ". createDomain (StringX8 , 
Properties, int) "; 

System. out . print In ("*** Made it into createDomain..."); 
if (count > retry) { 

rc - refundCard(pCustomerAccountId, aDomainName, 

CreateDomainPrice, CresateDomainWNRP, 
opt ionalAt tributes) 
throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} ' 

NSIWholesaleConnection conn ■ null; 
WSPResponse returnCode; 

// Double check to see if the domain really is available (to 
minimize charges) . 

// with immediate credits 

try { 

System. out . print In ("** 'Attempting to verify domain is 

available. ") ; 

WSPResponse wspResponse = verif yDomainName ( aDomainName); 
if (wspResponse. getMa j orResul tCode ( ) == 

WSPResponse . COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED) { 

// See if credit card information is available, if so get 

transaction 

System. out . print In (»*** Begining to do Charge Card 

Validation."); 

rc » ChargeCard(pCustomerAccountId, aDomainName, 

CreateDomainPrice, CreateDomainWNRP, 
optionalAttributesj ; 

if (rc != 0) { 

II Bad credit card. Return bad Code, 
throw new NSIWholesaleException (methodName + "Credit card 

declined for: " + 

aDomainName) ; 

} 

} else { 

// Domain name not available. Return bad code, 
throw new NSIWholesaleException (methodName + "Domain name 

not available: "+ 

aDomainName) ; 

} 

. ) 

catch (NSIWholesaleException e) { 

throw new NSIWholesaleException ( "Domain name previously 
taken:" + aDomainName); 

} 

//All o.k. create the domain. 

System. out .println ( " *** After the credit card interaction, 
going on to create a name . " ) ; 
try { 

conn = (NSIWholesaleConnect ion) pool. checkout () ; 
Properties allParmsAndAttrs » new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
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allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomer Account Id) ; 

allParmsAndAttrs . put ( PARM_CUS TOME R_P AS SWORD , 
pCustomerPassword) ; 

allParmsAndAttrs .put (ATTR_DOMAIN_NAME, aDomainName); 

allParmsAndAttrs . put (ATTR_HOST_NAMEl , aHostNamel) ; 

allParmsAndAttrs. put (ATTR_HOST_ADDRl, aHostAddrl) ; 

allParmsAndAttrs. put (ATTR_HOST_NAME2, aHostName2) ; 

allParmsAndAttrs . put (ATTR_HOST_ADDR2 , aHostAddr2 ) ; 

allParmsAndAttrs. put (ATTRJTECH_CONTACT_ID, aTechContactld) 

returhCode ■ conn . make Request (COMBO_CREATE_DOMAIN, 

allParmsAndAttrs) ; 

pool. checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

. } 

catch (ResourceException re) { 

System. err. println (me thodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return createDomain ( 

pCustomer Account Id, 
pCustomerPassword, 
aDomainName, 
aHostNamel, 
aHostAddrl, 
"~~aHostName2, 
aHostAddr2, 
aTechContactld, 
optionalAttributes , 
count + 1) ; 



/** 

* This method registers a new .domain product for an existing 

* customer account. This request assumes that the domain 
. . * name will be hosted by some organization other than 

* Network Solutions. . 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED__PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEINGJ*ETURNED 
Expected Result Property Key(s) Returned: 
ATTR_ISP_PASSWORD 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ®param aDomainName the attribute value 
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* ©param aHostldl the attribute value 

* ©param aHostId2 the attribute value 

* ©param aTechContactld the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesal e AP I # COMMAND_CRE ATE 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSlwholesaleAPl#COMBO_CREATE_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER~PASSWORD 
■* ©see NSIWholesaleAPI # ATTR_DOMA I N_NAM E 

* ©see NSIWholesaleAPI#ATTR_HOST_IDl 

* ©see NSIWholesaleAPI#ATTR_HOST_ID2 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#GENERAL~ACCESS_DENIED 

* ©see WSPResponse#INVALID~VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_ISP_PASSWORD 

*/ 

public WSPResponse createDomain ( 
String pCustomerAccountld, 
String pCustomerPassword, 
String aDomainName , 
String aHostldl, 
String aHostId2, 
String aTechContactld 
) 

throws NSIWholesaleException { 
return createDomain ( 

pCustomerAccountld, 
pCustomerPassword, 
aDomainName, 
aHostldl, 
aHostId2, 
aTechContactld, 
new Properties () , 
. .0); 

} 

/** 

* This method registers a new domain product for an existing 

* customer account. This request assumes that the domain 

* name will be hosted by some organization other than 

* Network Solutions. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

.... * COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

. Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_I S P_PASSWORD 

* </PRExBR> 
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* ©param pCustomer Account Id the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param aDomainName the attribute value 

* ©param aHostldl the attribute value 

* ©param aHostId2 the attribute value 

* ©param aTechContactld the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NS I Whole sale API #COMMAND_CREATE 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_CREATE_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARMj:USTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR~DOMAIN_NAME 

* ©see NSIWhoiesaleAPI#ATTR~HOST_IDl 

* ©see NSIWholesaleAPI#ATTR_HOST_ID2 

* ©see NS I Who lesaleAPI # ATTR_TECH~CONTACT_I D 
* 

* ©see WSPResponse#COMMAND_FAILEDJJNKNOWN_ERROR 

* ©see WS PRe spons e #GENERAL_ACCES S_DENI ED 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTR_ISP_PASSWORD 
* 

pubiic WSPResponse createDomain ( 
String pCustomer Account Id, 
String pCustomerPassword, 
String aDomainName, 
String aHostldl, 
String aHostId2, 
String aTechContactld, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return createDomain ( 

pCustomer Ac count Id, 

pCustomerPassword, 

aDomainName, 

aHostldl, 

aHostId2, 

aTechContactld, 

optionalAttributes, 

0); 

} 

protected WSPResponse createDomain ( 

String pCustomer Account Id, 

String pCustomerPassword, 

String aDomainName, 

String aHostldl, 

String aHostId2, 

String aTechContactld, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 
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String methodName = className + n .createDomain (StringX6, 
Properties, int) "; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn '« (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ;. 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_PAS SWORD, 
pCustomerPassword) ; 

allParmsAndAttrs .put (ATTR_DOMAIN_NAME, aDomainName) ; 

allParmsAndAttrs. put (ATTR__H0ST_ID1, aHostldl) ; 

allParmsAndAttrs. put (ATTR_HOST_ID2 , aHostId2) ; 

allParmsAndAttrs .put (ATTR_TECH_CONTACT_ID, aTechContactld) 

returnCode = conn . makeRequest ( COMBO_CREATE_DOMAIN , 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { _ 

pool . release (conn) ; 

> 

catch (ResourceException re) { 

System. err. println (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return createDomain ( 

pCustomerAccountld, 

pCustomerPassword, 

aDomainName, 

aHostldl, 

aHostId2, 

aTechContactld, 

optionalAttributes, 

count + 1) • 

j 

} 

} 

/** 

* This method registers a DNS Hosting product for an existing 

* customer account. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 
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* <BRxPRE> 

Expected Major Result Code: . . 

COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_DNS_HOSTING_CREATED 
. ATTR_ISP_PASSWORD 

* </PRExBR> 

* ©param pCustomer Account Id the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param aDomainName the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale. toolkit. javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NS I Who lesaleAPI# COMMAND_CRE AT E 

* ©see NSIWholesaleAPI#CLASS_DNS_HOSTING 

* ©see NSIWholesaleAPI#COMBO_CREATE_DNS_HOSTING 

* ©see NSIWholesaleAPI#PARMj:USTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_DOMAIN_NAME 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND__EXECUTION_SUCCEEDED_PROPERTIES__BEING_RETURNED 

* ©See NS I Who 1 e S a 1 e AP I # ATTR__DNS_HOSTI NG_CREATED 

* ©see NSIWholesaleAPI#ATTR_ISP_PASSWORD 

public WSPResponse createDnsHosting ( 
String pCustomer Account Id, 
String pCustomerPassword, 
String aDomainName) 
throws NSIWholesaleException { 
return createDnsHosting ( 

pCustomerAccount Id 

pCustomerPassword, 

aDomainName, 

new Properties () , 

0); 

■ } ,. ■ 
/** 

* This. method registers a DNS Hosting product for an existing 

* customer account 

■ * <BR>N0TE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTI ES_BE ING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING__RETURNED 
Expected Result Property Key(s) Returned: 

ATTR_DNS_HOSTING_CREATED 

ATTR_I S P_PASSWORD 

* </PRExBR> 

* ©param pCustomerAccount Id the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param aDomainName the attribute value 

* ©param bptionalAttributes a property list of optional attributes 
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* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSI Whole saleAPI#COMMAND_CREATE 

5 * ©see NSIWholesaleAPI#CLASSJ)NS_HOSTING 

* ©see NSIWholesaleAPI#COMBO~CREATEJ)NS_HOSTING 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR DOMAIN_NAME 
10 ■ * 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
15 * ©see NS I Who 1 e s a 1 e AP I # ATTR_DNS_ HOST ING_CRE ATED 

* ©see NSIWholesaleAPI#ATTR_ISP~PASSWORD 
* 

*/ 

public WSPResponse createDnsHosting ( 
20 String pCustomerAc count Id, 

String pCustomerPassword, 
String aDomainName, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
25 return createDnsHosting ( 

pCustomerAccountld, 
pCustomerPassword, 
aDomainName, 
optionalAttributes, 
30 0); 

} 

protected WSPResponse createDnsHosting ( 
String pCustomerAccountld, 
String pCustomerPassword, 
35 String aDomainName, 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + ". createDnsHosting (String, String, 
40 String, Properties, int) " ; 

if (count > retry) { 

rc = refundCard (pCustomerAccountld, aDomainName, 

CreateDnsHostPrice, CreateDnsHostWNRP, 
optionalAttributes); 

45 throw new NSIWholesaleException (methodName + "Unable to 

complete command" ) ; 

} • 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 
50 // Double check to see if the domain really is available (to 

minimize charges) 

// with immediate credits 
try { 

System. out .println ("***Attempting to verify domain for DNS 

55 Hosting.") ; 

WSPResponse wspResponse = verifyDomainName ( aDomainName); 
if. ( wspResponse. getMa j orResul tCode () == 
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WSPResponse.COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED) { 

// See if credit card information is available, if so get 



transaction 
Validation.") 



declined for: " + 



System. out .print In ("*** Begining to do Charge Card 

rc = ChargeCard(pCustomerAccountId, aDomainName, 

CreateDomainPrice, CreateDomainWNRp, 
optionalAttributes) ; 

if (rc ■ = 0) { 

// Bad credit card. Return bad code. 
. throw new NSIWholesaleException (methodName + "Credit card 

aDomainName); 

} 

} else { 

// Domain name not available. Return bad code, 
throw new NSIWholesaleException (methodName + "Domain name 



not available: "+ 



aDomainName) ; 

} 

} 

/; catch (NSIWholesaleException e) { 

throw new NSIWholesaleException ( "Domain name previously 
taken : " + aDomainName) ; 

} 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 



//put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes):; 

allParmsAndAttrs . put (PARM_CUST0MER_ACCOUNT_ID, 
pCustomer Account Id) ; 

allParmsAndAttrs .put ( PARM_CUSTOMER_PAS SWORD, 
pCustomer Pas sword) ; 

allParmsAndAttrs .put (ATTR_DOMAIN_NAME, aDomainName); 

returnCode = conn.makeRequest (COMBO_CREATE_DNS_HOSTING # 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return createDnsHosting ( 
pCustomerAccountld, 
pCustomerPassword, 
aDomainName, 
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optionalAttributes , 
count + 1) ; 

} 



■ /** 

* This method allows a customer to modify one or more attributes 

* associated with a specific instance of a Domain product 

* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EX ECUT I ON_S UCC EED ED_NO_D ATA_BE I NG_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aHostNamel the attribute value 

* ©param aHostAddrl the attribute value 

* ©param aHostName2 the attribute value 

* ©param aHostAddr2 the attribute value 

* ©param aTechContactld the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAlN 

* ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#PARM_DOMAIN_NAME 

* ©see NS I Whol e sal e API # ATTR_HOST_NAME 1 

* ©see NSI Wholes a leAPI#ATTR_HOST_ADDRl 

* ©see NS I Whole sale API #ATTR_HOST_NAME2 

* ©see NSIWholesaleAPI#ATTR_HOST_ADDR2 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 

* ■ 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#INVALID_VALUE 

■ * . ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see WSPResponse#COMMAND_EXEGUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

*/ 

public WSPResponse modifyDomain ( 
String pCustomerAccountld, 
String pCustomerPassword, 
String pDomainName, 
String aHostNamel, 
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String aHostAddrl , 
String aHostName2, 
String aHostAddr2, 
String aTechContactld 

) 

throws NSIWholesaleException { 
return modifyDomain{ 

pCustomerAccountld, 

pCus tomer Pas sword , 

pDomainName, 

aHostNamel, 

aHostAddrl, 

aHostName2, 

aHostAddr2, 

aTechContactld, 

new Properties () , 

0); 

} 

/** 

* This method allows a customer to modify one or more attributes 

* associated with a specific instance of a Domain product 

* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXE CUT I ON__S UCCEEDED_NO__DATA_B E I NG__RETURNE D 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value - " 

* ©param pDomainName the parameter value 

* ©param aHostNamel the attribute value 

* ©param aHostAddrl the attribute value 

* ©param aHostName2 the attribute value 

* ©param aHostAddr2 the attribute value 

* ©param aTechContactld the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASSJX)MAIN 

* ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#PARM_DOMAIN_NAME 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_HOS T_NAM E 1 

* ©see NSIWholesaleAPI#ATTR_HOST_ADDRl 

* ©see NSIWholesaleAPI#ATTR_HOST_NAME2 

* ©see NSIWholesaleAPI#ATTR_HOST_ADDR2 

* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 

* "*"" "~. 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#INVALID_VALUE 
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* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

5 WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
. * ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 
* 

*/ 

public WSPResponse modifyDomain( 
10 String pCustomerAccountld, 

String pCustomer Pas sword, 
String pDomainName, 
String aHostNamel, 
String aHostAddrl, 
15 .String aHostName2, 

String aHostAddr2, 
String aTechContactld, 
Properties optionalAttributes) 
throws NSlWholesaleException { 
20 return modifyDomain ( 

pCustomer Ac count Id , 
pCustomerPassword, 
pDomainName, 
aHostNamel, 

25 aHostAddrl, 

aHostName2, 

aHostAddr2 , 

aTechCon t ac t Id , 

optionalAttributes , 
30 0); 

} 

protected WSPResponse modifyDomain( 
String pCustomerAccountld, 
String pCustomerPassword, 
35 String pDomainName, 

String aHostNamel, 
String aHostAddrl, 
String aHostName2, 
String aHostAddr2, 
40 String aTechContactld, 

Properties optionalAttributes, 
int count) 
throws NSlWholesaleException { 

String methodName « className + ".modifyDomain (St ringX8 , 
45 Properties, int) " ; 

if (count > retry) { 

throw new NSlWholesaleException (methodName + "Unable to 
complete command 1 '); 

50 NSIWholesaleConnection conn = null; 

WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnect ion)pool. checkout () ; 
55 Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 
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proper t iesCat (allParmsAndAttrs, opt ionalAt tributes) ; 

allParmsAndAttrs.put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_PASSWORD, 
pCustomerPassword) ; 

allParmsAndAttrs . put (PARM_DOMAIN_NAME, pDomainName); 

allParmsAndAttrs . put (ATTR~H0ST_NAME1 , aHostNamel ) ; 

allParmsAndAttrs.put (ATTR_H0ST~ADDR1 , aHostAddrl) ; 

allParmsAndAttrs . put (ATTR_H0ST_NAME2 , aHostName2 ) ; 

allParmsAndAttrs .put (ATTR_H0STJ\DDR2 , aHostAddr2) ; 

allParmsAndAttrs.put (ATTR~TECH_CONTACT_ID, aTechContactld) 

returnCode - conn . makeRequest (COMBO_MODIFY_DOMAIN, 

allParmsAndAttrs); 

pool . checkln (conn) / 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. println (methodName + "Caught 
ResourceException" + re) ; 

> 

finally { 

return modif yDomain ( 

pCus tomerAccount Id , 
pCustomerPassword, 
pDomainName , 
aHostNamel, 
aHostAddrl, 
aHostName2, 
aHostAddr2, 
aTechContactld, . 
optionalAttributes , 
count + 1 ) ; 

} 



/** 

* This method allows a customer to modify one or more attributes 

* associated with a specific instance of a Domain product 

* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE>. ... 

Expected Major Result Code: 
COMMAND^ EXE CUT I ON_SUCCEEDED_NO_DATA_B EI NG__RETURNED 

* </PRExBR> 

. * ©param pCustomerAccountld the parameter value 

* Oparam pCustomerPassword the parameter value 
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* ©param pDomainName the parameter value 

* ©param aHostldl the attribute value 

* ©param aHostId2 the attribute value 

* ©param aTechContactld the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSlWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

• * ©see NSIWholesaleAPI#COMBO^MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUTUT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NS I Who 1 e s a 1 e AP I # P ARM~D0MAI N_N AME 

* ©see NSIWholesaleAPI#ATTR_HOST_IDl 

* ©see NSIWholesaleAPI#ATTR_HOST_ID2 

* ©see NSIWholesaleAPI#ATTRJTECH_COOTACT_ID . 
* 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WS PRe spons e # INVAL I DEVALUE 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES._BEING_RETURNED 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

*/ 

public WSPResponse modifyDomain ( • 
String pCustomerAccountld, 
String pCustomerPassword, 
String pDomainName, 
String aHostldl, 
. String aHostId2, 

String aTechContactld 
) 

throws NSIWholesaleException { 
return modifyDomain ( 

pCustomerAccountld, 

pCustomerPassword, 

pDomainName, 

aHostldl, 

aHostId2, 

aTechContactld, 

new Properties () , 

0); 

} 

/**■ 

* This method allows a customer to modify one or more attributes 

* associated with a specific instance of a Domain product 

* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 
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Expected Major Result Code: 
COMMAND_EX ECUTI ON_S UCC EEDED_NO_DATA_B E I NG_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 
5 * ©param pCus tome r Pas sword the parameter value 

* ©param pDomainName the parameter value 

* ©param aHostldl the attribute value 

* ©param aHostId2 the attribute value 

* Oparam aTechContactld the attribute value 

10 * ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale. toolkit. javaapi .NSlWholesaleException "when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_M0DIFY 
15 * ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NS I Whole s a 1 e API #COMBO_MODI FY__DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NS I Who lesaleAPI# PARM_DOMAI N_N AME 
20 * ©see NSlWholesaleAPl#ATTR_HOST_lDl 

* ©see NSIWholesaleAPI#ATTR_HOST_ID2 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 

* @see : WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 
25 * ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

30 WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see NSIWhblesaleAPI#ATTR_TECH__CONTACT_ID 

*/ 

public WSPResponse modifyDomain( 
35 String pCustomerAccountld, 

String pCustomer Password, 
String pDomainName, 
String aHostldl, 
String aHostId2, 
40 String aTechContactld, 

.Properties optionalAttributes) 
throws NSlWholesaleException { , 
return modi f yDomain ( 

pCustomerAccountld, 

45 

pCustomer Password, 
pDomainName, 
aHostldl, 
aHostId2, 
aTechContactld, 
50 optionalAttributes, 

0); 

} 

protected WSPResponse modif yDomain ( 
String pCustomerAccountld, 
55 String pCustomer Pass word, 

.. String pDomainName, 
String aHostldl, 
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String aHostId2, . 
String aTechContactld, 
Properties optionalAttributes, 
int count) 

5 throws NSIWholesaleException { 

String methodName = className + " .modifyDomain(StririgX6, 
Properties, int) 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
'10 complete command"); 

} . 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

15 try { 

conn a (NSIWholesaleConnection) pool .checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 
20 . propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs. put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAc count Id) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_PAS SWORD, 
25 pCustomerPassword) ; 

allParmsAndAttrs . put ( P ARM_DOMA I N_N AM E , pDomainName) ; 
allParmsAndAttrs. put (ATTR_H0ST_ID1, aHostldl) ; 
allParmsAndAttrs. put '(ATTR_HOST_ID2, aHostId2) ; 
allParmsAndAttrs .put (ATTR_TECH_CONTACT ID,. aTechContactld) ; 

30 

returnCode = conn . make Re quest (COMBO_MODIFY_DOMAIN, 

allParmsAndAttrs) ; 

pool. checkln (conn) ; 
return returnCode; 
35 } catch (Exception e) { 

try { 

pool . release (conn) ; 

. } 

catch (ResourceException re) { 
40 . System. err. print In (methodName + "Caught 

ResourceException" + re) ; 

} 

finally { 

return modifyDomain( 
45 pCustomer Account Id, 

pCustomerPassword, 
pDomainName, 
aHostldl, 
aHostId2, 

50 aTechContactld, 

optionalAttributes, 
count + 1) ; 

} . 

} 

55 } 
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/** 

* This method allows a technical contact of a customer's domain 

* product to modify one or more attributes 

* associated with that specific instance of the Domain product 
5 * registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* < BR > NOTE : This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 
10 * indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUT ION_S UCCEEDED_NO_DATA_BE I NG_RETURNED 

* </PRExBR> 

15 * ©param pCustomerAccountld the parameter value 

* ©param pTechContactld the parameter value 

* ©param pTechContact Password the parameter value 

* ©param pDomainName the parameter value 

* ©param aHostNamel the attribute value 
20 * ©param aHostAddrl the attribute value 

* ©param aHostName2 the attribute value 

* ©param aHostAddr2 the attribute value 

* ©param aTechContactld the attribute value 

* ©param optionalAttributes a property list of optional attributes 
25 * ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSlWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMANDJ*ODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

30 " * ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_ID 

■ * ©see NSIWholesaleAPI#PARMJTECH_CONTACT_PASSWORD 

* ©see NSIWholesal e AP I # PARM_DOMA IN_NAME 
35 * ©see NSIWholesaleAPI#ATTR_HOST_NAMEl 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_H0ST_ADDR1 

* ©see NS I Whol es aleAP I #ATTR_HOST_NAME2 

* ©see NS I Who 1 e s a 1 e A P I # ATTR_HOS T_ADD R2 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
40 * 

' * ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION - SUCCEEDED_NO_DATA_BEING_RETURNED 
45 * ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

' * 

*/ 

public WSPResponse modifyDomain( 
50 String pCustomerAccountld, 

String pTechContactld, 

String pTechContact Password, 

String pDomainName, 

String aHostNamel, 
55 String aHostAddrl, 

String aHostName2, 

String aHostAddr2, 
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String aTechContactld 
) 

throws NSIWholesaleException { 
return . modif yDomain ( 

pCus t ome r Ac count I d , 

pTechContactld, 

pTechContactPassword, 

pDomainName, 

aHostNamel, 

aHostAddrl, 

aHostName2, 

aHostAddr2, 

aTechContactld, 

new Properties () , 

0); 

} • 
/** 

* This method allows a technical contact of a customer's domain 

* product to modify one or more attributes 

* associated with that specific instance of the Domain product 

* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value : 

* ©param pDomainName the parameter value 

* ©param aHostNamel the attribute value 

* ©param aHostAddrl the attribute value 

* ©param aHostName2 the attribute value . 

* ©param aHostAddr2 the attribute value 

■ * ©param aTechContactld the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#C0MMANDJ40DIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_PASSWORD 

* ©see NS I Who 1 e s a 1 e AP I # PARM__DOMAIN_NAME 

* ©see NS I Whol e sal e AP I # ATTR_HOST_NAME 1 

* ©see NS IWholesal e AP I # ATTR_HOS T_ADDR 1 

* ©see NS I Whol e sa 1 eAPI #ATTR_H0ST_NAME2 

* ©see NSI Whole sale API #ATTR_H0ST_ADDR2 . 

* ©see NSIWholesaleAPI#ATTR_TECH_CONTACT_ID 
* 

* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 
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* ©see ■ WSPResponse#INVALID_VALUE 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse modifyDomain( 
String pCustomer Account Id, 
String pTechContactld, 
String pTechCont act Pas sword, 
String pDomainName, 
String aHostNamel, 
String aHostAddrl, 
String aHostName2, 
String aHostAddr2, 
String aTechContactld, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return modifyDomain ( 

pCustomerAc count Id, 

pTechContactld, 

pTe chCon t a c t Pa s s wo rd , 

pDomainName, 

aHostNamel, 

aHostAddrl, 

aHostName2, 

aHostAddr2 # 

aTechContactld, 

optionalAttributes, 

0); 

} . 

protected WSPResponse modi f yDomain ( 

String pCustomer Account Id, 

String pTechContactld, 

String pTechCont act Pas sword, 

String pDomainName, 

String aHostNamel, 

String aHostAddrl, 

String aHostName2 

String aHostAddr2 , 

String aTechContactld, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName » className + n .modifyDomain (StringX9, 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

. } 

NSIWholesaleConnection conn ■ null; 
WSPResponse returnCode; 

try { 

conn a (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 
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// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

5 allParmsAndAttrs. put (PARM_CUSTOMER_ACCOUNT_ID, 

pCustomerAccountld) ; 

allParmsAndAttrs .put (PARMJTECH_CONTACT_ID, pTechContactld) ; 
all ParmsAndAt trs . put ( PARM JTECH_CONTACT~PAS SWORD , 
pTechContactPassword) ; 
10 allParmsAndAttrs. put ( PARM_DOMAIN_NAME , pDomainName); 

allParmsAndAttrs. put (ATTR_HOST_NAMEl, aHostNamel); 
allParmsAndAttrs .put (ATTR_HOST_ADDRl, aHostAddrl); 
allParmsAndAttrs . put (ATTR_HOST_NAME2 , aHostName2) ; 
allParmsAndAttrs .put (ATTR_HOST_ADDR2 , aHostAddr2) ; 
15 allParmsAndAttrs. put (ATTR_TECH_CONTACT_ID, aTechContactld) ; 

returnCode = conn.makeRequest (COMBO_MODIFY_DOMAIN, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
20 return returnCode; 

} catch (Exception e) { 
try { 

pool. release (conn) ; 

25 catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

30 return modifyDomain( 

pCustomerAccountld, 
pTechContactld, 
pTechContactPassword, ■ 
pDomainName, 

35 aHostNamel, 

aHostAddrl, 

aHostName2, 

aHostAddr2, 

aTechContact Id , 
40 . optionalAttributes, 

count + 1) ; 

} 

} 

} ' 

45 

/** 

* This method allows a technical contact of a customer's domain 

* product to modify one or more attributes 

50 * associated with that specific instance of the Domain product 

* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

55 * COMMAND_EXECUTION_SUCCEEDED^PR0PERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 
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Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 
5 * ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aHostldl the attribute value 

* ©param aHostId2 the attribute value 

10 * ©param aTechContactld the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 
15 * ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBOJ40DIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_PASSWORD 
20 * ©see NS I Who 1 e s a 1 e AP I # PARM_DOMAI N_NAME 

* ©see NSIWholesaleAPI#ATTR_HOST_IDl 

* ©see NSIWholesaleAPI#ATTR_H0ST_ID2 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 
* 

25 * ©see WSPResponse#COMMAND_FAILEDJJNKNOWN_ERROR 

* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#GENERAL_ACCESSJDENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

30 WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse modifyDomain( 
String pCustomerAccountld, 
35 String pTechContactld, 

String pTechContactPassword, 
String pDomainName, 
• String aHostldl, 
String aHostId2, 
40 String aTechContactld 

) 

throws NSIWholesaleException { 
return modif yDomain ( 

pCustomerAccountld, 
45 pTechContactld, 

pTechContactPassword, 
pDomainName, 
aHostldl, 
aHostId2, 

50 aTechContactld, 

new Properties () , 
0); 

} 

/** 

55 * This method allows a technical contact of a customer's domain 

* product to modify one or more attributes 

* associated with that specific instance of the Domain product 
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* registered to that customer. 

* This method will also convert a DNS Hosting product domain 

* into a standard domain. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aHostldl the attribute value 

* ©param aHostId2 the attribute value 

* ©param aTechContactld the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_PASSWORD 

* ©see NSIWholesal eAP I # PARM_DOMAI N_NAME 

* ©see NSIWholesaleAPI#ATTR_HOST_IDl 

* ©see NSIWholesaleAPI#ATTR_HOST_ID2 

* ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 



* ©see WSPResponse#COMMAND_FAILED_UNKNOWN_ERROR 

* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMI^D_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 



WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 



public WSPResponse modif yDomain ( 
String pCustomerAccountld, 
String pTechContactld, 
String pTechContactPassword, 
String pDomainName, 
String aHostldl, 
String aHostId2; 
String aTechContactld, 
Properties optionalAttributes) 

throws NSIWholesaleException { 
return modif yDomain ( 



pCus tomer Account Id , 

pTechContactld, 

pTechContactPassword, 

pDomainName, 

aHostldl, 

aHostId2, 



* 



* 



©see 



*/ 
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aTechContactld , 
optionalAttributes, 
0) ; 

} 

protected WSPResponse modif yDomain ( 

String pCustomerAccountld, 

String pTechContactld, 

String pTechContact Password, 

String pDomainName, 

String aHostldl, 

String aHostld2, 

String aTechContactld, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName = className +. ■ .modif yDomain (St ringX7, 
Properties, int) "; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

II put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_TECH_CONTACT_ID, pTechContactld) ; 

allParmsAndAttrs .put ( PARM_TECH_CONTACT_PASSWORD , 
pTechContactPassword) ; 

allParmsAndAttrs. put { PARM_DOMAIN_NAME , pDomainName); 

allParmsAndAttrs. put (ATTR_H0ST_ID1 , aHostldl); 

allParmsAndAttrs. put (ATTR_HOST_ID2 , aHostId2) ; 

allParmsAndAttrs . put ( ATTR_TECH_CONTACT_ID , aTechContactld) ; 

returnCode = conn . makeRequest (COMBO_MODIFY__DOMAIN, 

allParmsAndAttrs) ; 

pool. checkln( conn ) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return modif yDomain ( 

pCustomerAccountld, 
pTechContactld, 
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10 



pTechContact Password, 

pDomainName, 

aHostldl, 

aHostId2 , 

aTechContactld, 

optionalAttributes, 

count + 1) ; 



15 



20 



25 



30 



35 



/** 

* This method allows an Internet Service Provider (ISP) 

* to modify the Technical Contact Id of a specific domain product. 

* <BR>N0TE: This command is asynchronous. Receipt of the 

* COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BR><PRE> 

Expected Major Result Code: 
C0MMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param plspPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aTechContactld the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit .javaapi .NSlWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_MODIFY_DOMAIN 

* ©see NSIWholesaleAPI#PARM_OJSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_ISP_PASSWORD 

* ©see NSIWholesaleAPI#PARMJDOMAIN_NAME 

* ©see NSIWholesaleAPI#ATTR TECH CONTACT ID 



40 



* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 



45 



50 



55 



public WSPResponse modif yDomain ( 
String pCustomerAccountld, 
String plspPassword, 
. String pDomainName, 
String aTechContactld 
) 

throws NSlWholesaleException { 
return modif yDomain ( 

pCustomerAccountld, 

plspPassword, 

pDomainName, 

aTechContactld, 

new Properties 0# 

0); 

} 



-98- 



WO 01/20484 HH ^^PCT/USOO/25305 



* This method allows an Internet Service Provider (ISP) 

* to modify the Technical Contact Id of a specific domain product. 

* <BR>NOTE: This command is asynchronous. Receipt of the 

5 . * COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED code 

* indicates that the command has been successfully queued. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EX ECUT ION_SUCCEEDE D_NO_DATA_BE I NG_RETURNED 
10 * </PRExBR> 

* ©par am pCustomer Account Id the parameter value 

* ©param plspPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param aTechContactld the attribute value 

15 * ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 
20 * ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBOJ10DIFYJDOMAIN 

. * ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_lSP_PASSWORD 

* ©see NS I Who 1 e s a 1 eAP I # PARM_DOMAIN_NAME 

25 * ©see NSIWholesaleAPI#ATTRJTECH_CONTACT_ID 

* 

* ©see WSPResponse#INVALID_VALUE 

*' ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING__RETURNED 

30 

*/ 

public WSPResponse modif yDomain ( 
: String pCustomerAccountld, 

String plspPassword, 
35 String pDomainName, 

String aTechContactld, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return modifyDomain( 
40 pCustomerAccountld, 

plspPassword, 
pDomainName, 
aTechContactld, 
optionalAttributes, 
45 0) / 

; } 

protected WSPResponse modif yDomain ( 
String pCustomer Ac count Id, ' 
String plspPassword, 
50 String pDomainName, 

String aTechContactld, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 
55 String methodName = className + * .modif yDomain (StringX4, 

Properties, int) " ; 

if (count > retry) { 
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throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

) 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

proper tiesCat (allParmsAndAttrs, opt ionalAt tributes ) ,• 



allParmsAndAttrs .put ( PARM_CUSTOMER_ACCOUNT_ID, 
15 pCustomerAccountld) ; 

allParmsAndAttrs. put (PARM_ISP_PASSWORD, plspPassword) ; 
allParmsAndAttrs .put (PARM_DOMAIN_NAME, pDomainName) ; 
allParmsAndAttrs. put (ATTR~TECH_CONTACT_ID, aTechContactld) ; 

20 returnCode = conn .makeRequest ( COMBO^MOD I FY — DOMAIN, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
25 try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
30 ResourceException" + re) ; 

} 

finally { 

return modif yDomain ( 

pCustomerAccountld, 
35 plspPassword, 

pDomainName, 
aTechContactld, 
optionalAttributes, 
count + 1 ) ; 

40 } 

} 

} 

45 /** 

* This method is used to modify one or more attributes 

* of an existing individual customer account. 

* <BRxPRE> 

Expected Major Result Code: 
50 COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomer^as sword the parameter value 

* ©return the Wholesale Server Protocol Server response 

55 * ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 

unable to complete command 

* ©see NSIWholesaleAPI#COMMAND MODIFY 
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* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_MODIFY_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER PASSWORD 
5 * ~ 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 
V ©see NSIWholesaleAPI#ATTR_FIRST_NAME 

* ©see NSIWholesaleAPI#ATTR_LAST_NAME 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_ADDRE SSI 
10 * ©see NS I Who 1 e s a 1 e AP I # ATTR__ADDRESS 2 

* ©see NSIWholesaleAPI#ATTR~ADDRESS3 

* ©see NSIWholesaleAPI#ATTR_ADDRESS4 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_ADDRESS 5 

* ©see NSlWholesaleAPl#ATTR_CITY 
15 * ©see NSIWholesaleAPI#ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSlWholesaleAPI#ATTR~COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_FAX 
20 * ©see NS I Who 1 e s a 1 e AP I # ATTR_EMAI L 

* ©see NSIWholesaleAPI#ATTR__AUTH_QUESTION 

* ©see NS I Who 1 e s a 1 eAPI # ATTR_AUTH_ANS WER 
• * 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 
25 * ©see WSPResponse#INVALID_VALUE 

©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 



* 



public WSPResponse modi fylndividual Account ( 
30 String pCustomer Account Id, 

String pCustomerPassword) 
throws NSIWholesaleException { 

return modifylndividualAccount ( 
pCu s t ome r Ac coun t I d , 
35 pCustomerPassword, 

new Properties () , 
0); 

/** 

40 . * This method is used to modify one or more attributes 

* of an existing individual customer account. 

* <BRxPRE> 

Optional Attribute Key(s) : 

ATTR_CUSTOMER_PASSWORD 
45 ATTR_FIRST_NAME 

ATTRJbAST_NAME 
ATTR_ADDRESS1 
. ATTR_ADDRESS2 
ATTR_ADDRESS3 

50 ^ ATTR_ADDRESS4 

ATTR_ADDRESS5 

ATTR_CITY 

ATTR_STATE 

ATTR_POSTAL_CODE 
55 ATTR_COUNTRY_CODE 

ATTR_PHONE 

ATTR~FAX 
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ATTR_EMAIL 

ATTR_AUTH_QUESTION 

ATTR_AUTH_ANSWER 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomer Account Id the parameter value 

* ©param pCustomerPas sword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUOT 

* ©see NSIWholesaleAPI#COMBO_MODIFY_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

* ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_FIRST__NAME 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_L AS T_NAME 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_ADDRESS 1 

* ©see NS I Who lesaleAPI # ATTR^ADDRES S 2 

* ©see NSIWholesaleAPI#ATTR_ADDRESS3 

* ©see NS I Who 1 e s a 1 e AP I # ATTR__ ADDRESS 4 N 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_ADDRE S S 5 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NS I Who 1 e s a le AP I #ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 
*"@see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_FAX 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_EMAI L 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 

* ©see NS I Who 1 e s a 1 e A P I # ATTR_AUTH_ANS WE R 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* "~ 

*/ 

public WSPResponse modif y I ndi vidua 1 Account ( 
String pCustomerAccountld, 
String pCustomerPas sword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return modifylndividualAccount ( 

pCustomerAccountld, 

pCustomer Pas sword, 

optionalAttributes, 

0); 

} 

protected WSPResponse modifylndividualAccount ( 
String pCustomerAccountld, 
String pCustomerPas sword, 
Properties optionalAttributes, 



WO 01/20484 ^^CT/USOO/25305 

int count) 
throws NSIWholesaleException { 

String methodName = className + n . modify Individual Account (String, 
String, Properties, int) ■ ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

al 1 ParmsAndAt t rs . put ( PARM_CUSTOMER_ACCOUNT_ID , 
pCustomerAccountld) ; 

allParmsAndAttrs . put (PARM_CUSTOMER_PAS SWORD, 
pCustomerPassword) ; 

returnCode =» 

conn. makeRequest (C0MB0J40DIFY_INDIVIDUAL_ACC0UNT, allParmsAndAttrs) ; 
pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ,- 

} 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return modifylndividualAccount ( 
pCustomerAccountld, 
pCustomerPassword, 
optionalAttributes, 
count + 1) ; 

} 

} 

} 

/**. 

* This method is used to modify one or more attributes 

* of an existing business (organization) customer account. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTI ON_SUCCEEDE D_NO_DATA_BE I NG_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 
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* ©exception nsi .wholesale . toolkit . javaapi -NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO~MODIFY_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUST0MER_ACC0u7JT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

. * ©see NSIWholesaleAPI #ATTR_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#ATTR_COMPANY_NAME 

* ©see NSIWholesaleAPI#ATTR~COMPANY_TYPE 

* ©see NS I Whole sale API #ATTR_ADDRESS1 
. * ©see NSIWholesaleAPI #ATTR_ADDRESS2 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_ADDRES S 3 

* ©see NSIWholesaleAPI # ATTR_ADDRES S 4 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_ADD RES S 5 

* ©see NSIWholesaleAPI#ATTR_CITY 

* ©see NSIWholesaleAPI #ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_FAX 

* ©see NSIWholesaleAPI #ATTR_EMAIL 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 

* ©see NSIWholesaleAPI#ATTR_AUTH_ANSWER 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_FIRST_NAME 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_LAST_NAME 

* ©see NS I Whol es a 1 eAP I # ATTR_LEGAL_CONTACT_ADDRESS 1 

* ©see NS I Whol e sal eAP I # ATTR__LEGAL_CONTACT_ADDRE S S 2 

* ©see NSIWholesaleAPI #ATTR_LEGAL_CONTACT_ADDRESS 3 

* ©see NSIWholesaleAPI #ATTR_LEGAL_CONTACT_ADDRESS4 

* ©see NS I Who lesaleAPI # ATTR_LEG AL_CONTACT__ADDRE S S 5 

* ©see NS I Whol e sa 1 eAP I # ATTR_LEGAL_CONTACT_C I TY 

* ©see NS I Who lesaleAPI # ATTR_LEGAL_CONTACT_STATE 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_POSTAL_CODE 

* ©see NS I Whol e sa leAP I # ATTR_LEGAL_CONTACT__COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_PHONE . 
. * ©see NS I Whol esa 1 eAP I # ATTR_LEGAL_CONTACT_FAX 

* ©see NS I Wholesa leAP I # ATTR_LEGAL_CONTACT_FAX 
* 

* ©see WS PResponse#GENERAL_ACCESS_DENI ED 

* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* • 

*/ 

public WSPResponse modi fyBusiness Account ( 
String pCustomer Account Id, 
String pCustomerPassword) 
throws NSIWholesaleException { 

return modi fyBusiness Account ( 
pCustomerAccountld, 
pCustomerPassword, 
new Properties (), 
0); 

} 

/** 

* This method is used to modify one or more attributes 
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* of an existing business (organization) customer account . 

* <BRxPRE> 

Optional Attribute Key(s) : 
attr_customer_pas sword 
attr~company_name 
attr_company_type 
attr_address1 
attr_address2 
attr_address3 
attr_address4 
attr~address5 
attr_city 
attr_state 
attr_postal_code 
attr~country_code 

ATTR~ PHONE 

ATTR__FAX 

ATTR_EMAIL 

ATTR_AUTH_QUES T I ON 

ATTR_AUTH_ANSWER 

ATTR_LEGAL_CONTACT_FIRSTJJAME 

ATTR_LEGAL_CONTACTJaAST_NAME 

ATTR_LEGAL_CONTACT_ADDRES S 1 

ATTR JLEGAL_COOTACT_ADDRES S 2 

ATTR_LEGAL_CONTACT_ADDRESS3 

ATTR_LEGAL_CONTACT_ADDRESS4 

ATTR_LEGAL_CONTACT_ADDRES S 5 

ATTR_LEGAL_CONTACT_C I T Y 

ATTR_LEGAL_CONTACT_STATE 

ATTR_LEGAL_CONTACT_POSTAL_CODE 

ATTRJLEGAL_CONTACT_COUNTRY_CODE 

ATTRJ^EGAL_CONTACT_PHONE 

ATTR_LEGAL_CONTACT_FAX. 

ATTR_LEGAL_CONTACT_EMAIL 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomer Account Id the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#C0MBO_MODIFY_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARMj:USTOMER_PASSWORD 
* 

" * ©see NSIWholesaleAPI#ATTR_CUSTOMER_PASSWORD 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_COM P ANY_NAME 

* ©see NS I Wholesale API #ATTR_COMPANY_TYPE 

* ©see NS I Who lesaleAPI # ATTR_ADDRE SSI 

* ©see NSIWholesaleAPI#ATTR_ADDRESS2 

* ©see NSIWholesaleAPI#ATTR_ADDRESS3 

* ©see NSIWholesaleAPI#ATTR ADDRESS4 
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* ©see NSIWholesaleAPI#ATTR_ADDRESS5 
.* ©see NSIWholesaleAPI#ATTR_CITY * 

* ©see NSIWholesaleAPI#ATTR_STATE 

* ©see NSIWholesaleAPl#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTRJPHONE 

* @see.NSlwholesaleAPI#ATTR_FAX 

* ©see NSIWholesaleAPI#ATTR_EMAIL 

* ©see NSIWholesaleAPI#ATTR_AUTH_QUESTION 

* ©see NSIWholesaleAPI#ATTRJVUTH_ANSWER 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_FIRST_NAME 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_LAST NAME 

* ©see NS I Who 1 e s a 1 e A P I # ATTR_LEGAL_CONTACT_ADDRES S 1 

* ©see NS I Who 1 e s a 1 eAPI # ATTR_LEGAL_CONTACT_ADDRESS 2 

* ©see NS I Who lesaleAPI # ATTR_LEGAL_CONTACT_ADDRES S 3 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_L EGAL_CONT ACT~ADDRE S S 4 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_L EGAL_CONT ACT_ADDRE S S 5 

* ©see NS I Who lesaleAPI # ATTR_LEG AL_CONTACT_C I T Y 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_STATE 

* ©see NS IWholesaleAPI #ATTR_LEGAL_CONTACT_POSTAIt_CODE 

* ©see NSIWholesaleAPI#ATTR_LEGAL_CONTACT_COUNTRY_CODE 

* ©see NS I Who 1 e sa 1 eAP I # ATTR_LEGAL_CONTACT_PHONE 

* ©see NS IWhole saleAPI # ATTR_LEGAL_CONTACT_FAX 

* @s ee NS I Who le sa leAP I #ATTR_LEGAL_CONTACT_FAX 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©See WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING RETURNED 

*/ 

public WSPResponse modif yBusinessAccount ( 
String pCustomer Account Id, 
String pCustomer Pas sword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return modif yBusinessAccount ( 

pCustomerAccountld, 

pCustomer Pas sword, 

optionalAttributes, 

0); 

} 

protected WSPResponse modif yBusinessAccount ( 

String pCustomerAccountld, 

String pCustomer Password, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName = className + " .modif yBusinessAccount (String, 
String, Properties, int) •■; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 
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conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, opt ionalAt tributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs . put (PARM_CUSTOMER_PAS SWORD, 
pCustomerPassword) ; 

returnCode = corm.makeRequest (COMBO_M0DIFY_BUSINESS_ACCOUNT 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} ' . 

catch (ResourceException re) { 

System. err .println (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return modifyBusinessAccount ( 
pCustomerAccountld, 
pCustomerPassword, 
optionalAttributes, 
count + 1) ; 

} 

} 

" } 
/*■* 

* This method is used to modify one or more attributes 

* of an existing technical contact. 

* <BRxPRE> - . 

Expected Maj.or Result Code: 
COMMAND_EXECUTION — SUCCEEDED^ NO_DATA_BEING_RETURNED 

* </PRExBR> ■ 

* ©param pTechContactld the parameter value 

* ©param pTechContact Pas sword .the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_TECHNICAL_CONTACT 

* ©see NS I Who 1 e s a 1 e AP I # COMBO__ MOD I F Y_TECHN I CAL_CONTACT 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_PASSWORD 

* ©see NS I Who lesaleAPI# ATTR__F I RST_NAME 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_LASTJNAME 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_ORGAN I Z ATI ON 

* ©see NS I Who 1 e s a 1 e AP I # ATTR_ADDR ES S 1 

* ©see NSIWholesaleAPI#ATTR_CITY . 

* ©see NSIWholesaleAPItfATTR STATE 
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* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR_COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_FAX 

* ©see NSIWholesaleAPI#ATTR_EMAIIi 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

*/ 

public WSPResponse modifyTechnicalContact ( 
String pTechContactld, 
String pTechContact Pas sword) 
throws NSIWholesaleException { 

return modifyTechnicalContact ( 
pTechContact Id, 
pTechContactPassword , 
new Properties () , 
0); 

} 

/** 

* This method is used to modify one or more attributes 

* of an existing technical contact. 

* <BRxPRE> . 

Optional Attribute Key(s) : 

attr_first_name 

attr_last_name 

attrjdrganization 

attr~addressi 

attr_city 

ATTR_STATE 

ATTR_POSTAL_CODE 

ATTR_COUNTRY_CODE 

ATTR_EMAIL 

ATTR_FAX 

ATTR_PHONE 

Expected Major Result Code: 
C0MMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pTechContact Id the parameter value 

* ©param pTechContactPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASSJTECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#COMBO_MODIFY_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_PASSWORD 
* 

* ©see NSIWholesal e AP I # ATTR_F I RST_NAME 

* ©see NS I Who 1 e sale API #ATTR_LAST_NAME 

.* ©see NS I Who 1 e s a 1 e AP I # ATTR_ORG ANI 2 AT ION 

* ©see NSIWholesaleAPItfATTR ADDRESS 1 
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* ©see NSIWholesaleAPI#ATTR_ClTY 

* ©see NSIWholesaleAPI#ATTR_STATE 

* ©see NSIWholesaleAPI#ATTR_POSTAL_CODE 

* ©see NSIWholesaleAPI#ATTR^COUNTRY_CODE 

* ©see NSIWholesaleAPI#ATTR_PHONE 

* ©see NSIWholesaleAPI#ATTR_FAX 

* ©see NSIWholesaleAPI#ATTRJ3MAIL 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#INVALID_VALUE 

* ©see WS PRe s pons e # COMMAND_EX ECUT I ON__S UCCEEDED_NO_DATA_B E I NG_RETURNED 
*/ 

public WSPResponse mod ifyTechnical Contact ( 
String pTechContactld, 
String pTechContact Pas sword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return modifyTechnicalContact ( 

pTechContactld, 

pTechContact Password, 

optionalAttributes, 

0) ; 

} ■ 

protected WSPResponse modif yTechnicalContact ( . 
String pTechContactld, 
String pTechContactPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " .modif yTechnicalContact (String, 
String, Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command") ; 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool .checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes); 

• allParmsAndAttrs. put (PARM_TECH_CONTACT_ID, pTechContactld) ; 
allParmsAndAttrs .put (PARM_TECH_CONTACT_P AS SWORD, 
pTechContactPassword) ; 

returnCode = 

conn.makeRequest (COr4BO_MODIFy_TECHNICAL_CONTACT, allParmsAndAttrs) ; 
pool. checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 
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} 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

. } 

finally { 

return modif yTechnicalContact ( 
pTechContactld, 
pTechCon t ac t Pa s sword , 
optionalAttributes, 
count + 1) ; 



/** 

* This method is used to modify/reset a customer's account password. 

* <BRxPRE> 

Expected Major Result Code: 
COMMANDJ3XECUT I ON_S UCCEEDED_NO_DATA_BE I NG_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param aCustomer Pas sword the attribute value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit .javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_PASSWORD 

* ©see NSIWholesaleAPI#COMBO_MODIFY_PASSWORD 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#ATTRj:uSTOMER~PASSWORD 

* .... 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 
* 

*/ 

public WSPResponse modi fy Password ( 
String pCustomerAccountld, 
String aCustomer Pas sword) 
throws NSIWholesaleException { 
return modi fyPass word ( 

pCustomerAccountld, 
aCustomer Password, 
new Properties () , 
0); 

} 

/** 

* This method is used to modify/reset a customer's account password. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param aCustomer Pas sword the attribute value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 
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* ©exception nsi. wholesale. toolkit. javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_MODIFY 

* ©see NSIWholesaleAPI#CLASS_PASSWORD 

* ©see NSIWholesaleAPI#COMBOJ10DIFY_PASSWORD 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOuTJT_ID 

* ©see NSIWholesaleAPI#ATTR~CUSTOMER_PASSWORD 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING RETURNED 
*/ 

public WSPResponse modi fyPas sword ( 
String pCustomer Account Id, 
String aCustomerPassword, 
Properties opt ionalAt tributes) 
throws KfSIWholesaleException { 
return modif yPassword( 

pCustomerAccountld, 

aCustomerPassword, 

opt ionalAttributes , 

0); 

protected WSPResponse modi fyPass word ( 
String pCustomerAccountld, 
String aCustomerPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + " .modif yPassword (String, String, 
Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_OJSTOMER_ACCOUNT_ID, 
pCustomerAccountld); 

allParmsAndAttrs .put (ATTR_CUSTOMER_PAS SWORD, 
aCustomerPassword); 

returnCode = conn. makeRequest (COMBO_MODIFY_PAS SWORD, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool. release (conn) ; 
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} 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return modi fy Pas sword ( 

pCustomerAccountld, 
aCustomerPassword, 
opt ionalAt tributes , 
count + 1) ; 

} 



/** 

* This method is used to generate a list of available 

* domain names based on a specified list of keywords. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING__RETURNED 
Expected Result Property Key(s) Returned: 

DomainNameO : 

DomainNamel : 

DomainName2: 

DomainName3 : 

. . .etc. . . 

* </PRExBR> 

* ©param pKeyWords the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NS I Who 1 e s a 1 e AP I # COMMAND_GENERATE 

* ©see NSIWholesaleAPI#CLASS_DOMAIN_NAME 

* ©see NS I Who 1 e S a 1 eAPI #COMBO_GENERATE_DOMAIN__NAME 

* ©see NSIWholesaleAPI#PARMJCEY_WORDS 
* 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
★ 

public WSPResponse generateDomainName ( 

String pKeyWords) 
throws NSIWholesaleException { 

return generateDomainName ( 
pKeyWords , 
new Properties 0 , 
0); 

} 

/** 

* This method is used to generate a list of available 

* domain names based on a specified list of keywords. 

* <BRxPRE> 

Expected "Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
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DomainNameO: 
DomainNamel : 
DomainName2: 
DomainName3: 
. . .etc. 

* </PRExBR> 

* ©param pKeyWords the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_GENERATE 

* ©see NS I Whol e sal e AP I ft CLAS S_DOMAI N_NAME 

* ©see NS I Whol e s al e AP I # COMB0~GENERATE_D0MAIN_NAME 

* ©see NS I Who 1 e s a 1 eAP I # PARM_KE Y_WORDS 
* 

* ©see WSPResponse#COMMAND_EXECirriON_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse generateDomainName ( 
String pKeyWords, 
Properties optionalAttributes) 
throws NSIWholesaleExcept ion { 

return generateDomainName ( 
pKeyWords , 
optionalAttributes , 
0); 

} 

protected WSPResponse generateDomainName ( 
String pKeyWords, 
: Properties optionalAttributes, 
int count) 
throws NSIWholesaleExcept ion { 

String methodName = className + " .generateDomainName (String, 
Properties, int) 11 

it (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

. } 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
allParmsAndAttrs. put ( PARMJCEY_WORDS , pKeyWords); 
returnCode = conn . makeReques t ( COMBO_GENERATE_DOMAIN_NAME , 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
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} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

5 catch (ResourceException re) { 

Sys tern. err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

10 return generateDomainName ( 

pKey Words, 
optionalAttributes, 
count + 1) ; 

} 

15 } 
} 

/** 

20 * Retrieves a list of all domain products owned by customer. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEINGJ*ETURNED 
Expected Result Property Key(s) Returned: 
25 DomainNamel : 

DomainName2 : 
DomainName3: . 
. . .etc. 

* </PRExBR> 

30 * ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

35 * ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBOJLOOKUP_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM CUSTOMER PASSWORD 
40 * ~ ~ ■ ■ 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND EXECUTION SUCCEEDED PROPERTIES BEING RETURNED 
45 * ~ " ~ 

*/ 

public WSPResponse lookupDomain ( 
String pCustomerAccountld, 
String pCustomerPassword) 
50 throws NSIWholesaleException { 

return lookupDomain ( 

pCustomerAccountld, 
pCustomerPassword, 
new Properties () , 
55 0); 

} 
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* Retrieves a list of all domain products owned by customer. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTI ES_BE ING_RETURNED 
Expected Result Property Key(s) Returned: 

DomainNamel : 

DomainName2 : 

DomainName3 : 

* • • etc . . . 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASSJDOMAIN 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse lookupDomain( 
String pCustomerAccountld, 
String pCustomerPassword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return lookupDomain ( 

pCus tomerAccount Id , 

pCustomerPassword, 

optionalAttributes, 

0); 

} 

protected WSPResponse lookupDomain ( 
String pCustomerAccountld, 
String pCustomerPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + ". lookupDomain (String, String, 
Properties, int) M ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse retumCode; 

try { " 

conn « (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties 0 ; 
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// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

5 allParmsAndAttrs . put (PARM_CUSTOMER_ACCOUNT_ID, 

pCustomerAccountld) ; 

allParmsAndAttrs . put ( PARM_CUSTOMER_PAS SWORD, 
pCustomerPassword) ; 

10 returnCode = conn.makeRequest (COMBO_LOOKUP_DOMAIN, 

allParmsAndAttrs) ; 

pool. checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
15 try { 

pool. release (conn) ; 

) 

catch (ResourceException re) { 

System. err. pr int In (methodName + "Caught 
20 ResourceException" + re) ; 

} ' 
finally { 

return lookupDomain ( 

pCustomerAccountld, 
25 pCustomerPassword, 

optionalAttributes, 
count + 1 ) ; 

} 

} 

30 } 

/** >. 

* Retrieves detail information about a specific domain product 
35 * registered to a customer. This form of the lookup domain 

* command will also retrieve the status of the domain while 

* it is being processed or after it has failed. 

* <BR><PRE> 

Expected Major Result Code: 
40 COMMAND_EXECUTION_SUCCEEDED___PROPERTIES_BEING__RETURNED 

Expected Result Property Key(s) Returned : 
ATTR_DOMAIN_NAME 
ATTR JTECH_CONTACT_ I D 
ATTR_H0ST_NAME1 
45 ATTR_H0ST_ADDR1 

■ ATTR_H0ST_ID1 

. ATTR_HOST~NAME2 , 
ATTR_HOST_ADDR2 
ATTR_H0ST_ID2 
50 * </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* @param pCustomerPassword the parameter value 

* ©param pDomainName the parameter value 

* ©return the Wholesale Server Protocol Server response 

55 * ©exception nsi. wholesale. toolkit .javaapi.NSIWholesaleExcept ion when 

unable to complete command 

* ©see NSIWholesaleAPI#COMMAND LOOKUP 
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* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO~LOOKUPJ)OMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NS I Who 1 e s a 1 e A P I # PARM_DOMAI N_NAME 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see 

WSPResponse#CX)MMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RE'nJRNED 

* ©see WSPResponse#COMMAND_EXECUTION__SUCCEEDED_TEXT_BEING_RETURNED 

* . 

*/ 

public WSPResponse lookupDomain ( 
String pCustomerAccountld, 
String pCustomerPas sword, 
String pDomainName) 
throws NSIWholesaleException { 
return lookupDomain ( 

pCustomer Account Id, 

pCustomerPassword, 

pDomainName, 

new Properties () , 

0); 

} 

/•* 

* Retrieves detail information about a specific domain product 

* registered to a customer. This form of the lookup domain 

* command will also retrieve the status of the domain while 

* it is being processed or after it has failed. 

* <BR><PRE> 

Expected Major Result Code: 
COMMANDJEXECOTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

ATTRJDOMAIN_NAME 

ATTR_TECH_CONTACT_ID 

ATTR_H0ST_NAME1 

ATTR_HOST_ADDR 1 

ATTR_H0ST_ID1 

ATTR_HOST_NAME2 

ATTR_HOST_ADDR2 

ATTR_HOST_ID2 

* </PRExBR> 

* ©param pCustomerAccpuntld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NSIWholesaleAPI#PARM_DOMAIN_NAME 
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* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see WSPResponse#COMMAND_EXECUTION__SUCCEEDED_TEXT_BEING_RETURNED 

*/ 

public WSPResponse lookupDomain ( 
String pCustomerAccountld, 
String pCus tome r Pas sword, 
String pDomainName, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return lookupDomain ( 

. pCustomerAccountld, 
pCustomerPassword, 
pDomainName, 
optionalAttributes, 
0); 

} 

protected WSPResponse lookupDomain ( 

String pCustomerAccountld, 

String pCustomerPassword, 

String pDomainName, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName = className + ".lookupDomain (String, String, 
String, Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command");. 

} 

NSIWholesaleConnection conn = null; 
WS PRe spons e re t urnCode ; 

try { 

conn = (NSIWholesaleConnect ion) pool, checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes); 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT__ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_PASSWORD / 
pCustomerPassword) ; 

allParmsAndAttrs. put ( PARM_D0MAIN_NAME , pDomainName); 

returnCode = conn.makeRequest (COMBO_LOOKUP_DOMAIN, 

allParmsAndAttrs) ; 

pool. checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 
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catch (ResourceException re) { 

System. err . print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return lookupDomain ( 

pCus tomerAccount Id , 
pCus tomer Password , 
pDomainName, 
optionalAttributes , 
count + 1 ) ; 

} 



/** 

* Retrieves a list of the customer's domain products 

* for which the technical contact id is the technical contact. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

DomainNamel: 

DomainName2 : 

DomainName3 : 

. . .etc. . . 

* </PRExBR> 

* ©param pCus tomerAccount Id the parameter value 

* ©param pTechCohtactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . javaapi . NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASSJDOMAIN 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT__ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_PASSWORD 
★ 

* ©see WSPResponse#GENERAL__ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION__SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#C0MMAND_EXECUTI0N_SUCCEEDED_PROPERTIES_BBING_RETURNED 
*/ 

public WSPResponse lookupDomainByTechContact ( 
String pCus tomerAccount Id, 
String pTechContactld, 
String pTechContactPassword) 
throws NSIWholesaleException { 

return lookupDomainByTechContact ( 

pCustomerAccountld, 

pTechContactld, 

pTechContactPassword, 

new Properties () , 
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0) ; 

) 

* Retrieves a list of the customer's domain products 

* for which the technical contact id is the technical contact. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

DomainNamel: 

DomainName2 : 

DomainName3 : 

. . .etc. . . 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pTechContactld the parameter value 

* ©param pTechContactPassword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit . j avaapi . NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASSJDOMAIN 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_ID 

* ©see NSIWholesaieAPI#PARMJTECH_CONTACT_PASSWORD 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECOTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse lookupDomainByTechContact ( 
String pCustomerAccountld, 
String pTechContactld, 
String pTechContactPassword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return lookupDomainByTechContact ( 

pCustomerAccountld,, 

pTechContactld , 

pTechContactPassword, 

optionalAttributes, 

0) ; 

} • 

protected WSPResponse lookupDomainByTechContact ( 

String pCustomerAccountld, 

String pTechContactld, 

String pTechContactPassword, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName = className + 
" .lookupDomainByTechContact (String, String, String, Properties, int) " ; 

if (count > retry) { 



10 
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throw new NSIWholesaleException(methodName + "Unable to 
complete cotomand") ; 
} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout { ) ; 
Properties allParmsAndAttrs = new Properties () 

// put optional attributes 

propertiesCat (allParmsAndAttrs, opt ionalAt tributes) ; 



allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
15 pCustomerAccountld) ; 

allParmsAndAttrs. put ( PARM_TECH_CONTACT_ID , pTechContactld) ; 
. allParmsAndAttrs. put (PARMJTECH_CONTACT_PAS SWORD, 
pTechCont act Pas sword) ; 

20 returnCode = conn, make Reaves t (COMBO_LOOKUP_DOMAIN, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
25 try { 

pool . release (conn) ; 

} 

catch (ResourceExcep'tion re) { 

System, err .println(methodName + "Caught 
30 ResourceException" + re) ; 

} 

finally { 

return lookupDomainByTechContact ( 
pCustomerAccountld, 
35 pTechContactld, 

pTechContact Password, 
optionalAttributes, 
count + 1) ; 

} 

40 } 
} 

/** 

45 * Retrieves details of a specific domain product owned by customer, 

* for which the technical contact id is the technical contact for 

* the specific product. 

* <BR><PRE> 

Expected Major Result Code: 
50 COMMAND_EXECUTION_SUCCEEDED__PROPERTIES_BEING_RETURNED 

Expected Result Property Key(s) Returned: 

ATTR_DOMAIN_NAME 

ATTR_TECH_CONTACT_ID 

ATTR_H0ST_NAME1 

55 • attr~host_addri 

ATTR_H0ST_ID1 
ATTR HOST NAME 2 
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ATTR_HOST_ADDR2 
ATTR_HOST_ID2 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pTechContactld the parameter value 

* ©param pTechContact Pas sword the parameter value 

* ©param pDomainName the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale. toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO~WOKUP_DOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARMJTECH_CONTACT_PASSWORD 

* ©see NS I Who 1 e s a 1 e A P I # P ARM_DOMA I N_NAM E 
' * 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see 

WSPResponse#C0MMAND_EXECUTI0N_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 

* . 

*/ 

public WSPResponse lookupDomainByTechContact ( 
String pCustomerAccountld, 
String pTechContactld, 
String pTechContact Password, 
String pDomainName) 
throws NSIWholesaleException { 

return lookupDomainByTechContact ( 

pCustomerAccountld, 

pTechContactld, 

pTechContact Pa s sword , 

pDomainName, 

new Properties () , 

0); . 

} 

/** 

* Retrieves details of a specific domain product owned by customer, 

* for which the technical contact id is the technical contact for 

* the specific product- 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

ATTR_DOMAIN_NAME 

ATTRJTECH_CONTACT_ID 

ATTR_H0ST_NAME1 

ATTR~H0ST_ADDR1 

ATTR_H0ST_ID1 

ATTR_HOST_NAME 2 

ATTR_HOST_ADDR2 

ATTR_HOST_ID2 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pTechContactld the parameter value 
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* ©param pTechContactPassword the parameter value 

* ©param pDomainName the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* @see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DOMAIN 

* ©see NSIWholesaleAPI#COMBO~LOOKUPJDOMAIN 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_ID 

* ©see NSIWholesaleAPI#PARMJTECH~CONTACT_PASSWORD 

* ©see NSI Who lesaleAPI# P ARM_DOMA I N_N AME ~ 



* ©see WSPResponse#GENERAL_ACCESSJDENIED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

* ©see WSPResponse#COMMAND - EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 



public WSPResponse lookupDomainByTechContact ( 
String pCustomerAccountld, 
String pTechContactld, 
String pTechContactPassword, 
String pDomainName, 
Properties optionalAttributes) 

throws NSIWholesaleException { 

return lookupDomainByTechContact ( 



pCustomerAccountld, 
pTechCont ac t Id # 
pTechContactPassword, 
pDomainName, 
optionalAttributes , 
0) / 



String pCustomerAccountld, 
String pTechContactld, 
String pTechContactPassword, 
String pDomainName, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String met hodName = className + 
" . lookupDomainByTechContact (StringX4 , Properties, int) " ; 



if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 



NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

//. put optional attributes 



* 



* 
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propertiesCat (allParmsAndAttrs, opt ionalAt tributes) ,• 

al 1 ParmsAndAt t r s . put ( PARM JTUSTOMER JVCCOUNT_ID , 
pCustomerAccountld) ; 

al 1 ParmsAndAt trs. put (PARM_TECH_CONTACT_ID, pTechContactld) ; 

allParmsAndAttrs .put ( PARM~TECH_CONTACT~PAS SWORD , 
pTechContactPassword) ,* 

allParmsAndAttrs. put ( PARM_DOMAIN_NAME , pDomainName) ; 

returnCode, ■ conn.makeRequest (C0MBO_L00KUP_D0MAIN, 

allParmsAndAttrs) ; 

pool . checkln ( conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

}. 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return lookupDomainByTechContact ( 
pCustomerAccountld, 
pTechContactld, 
pTechContactPassword, 
pDomainName, 
opt ionalAt tributes, 
count + • 1 ) ; 

} 



/** 

* Retrieves a list of all domain names associated with 

* DNS Hosting products owned by customer. 

* <BR><PRE> 

Expected Major Result Code: 
C0M^4AND_EXECUTI0N_SUCCEEDED_PR0PERTIES - BEING_RETURNED 
Expected Result Property Key(s) Returned: 
DomainNamel: 
DomainName2 : 
DomainName3 : 
.. . .etc. . . 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPas sword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale, toolkit .javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSJWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DNS_HOSTING 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DNS_HOSTING 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMERJ>ASSWORD 
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* ©see WS PRespons e#GENERALr_ACCESS_DENI ED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED^_NO — DATA_BEING_RETORNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
# 

public WSPResponse lookupDnsHosting ( 
String pCustomerAccountld, 
String pCus tome rPas sword) 
throws NSIWholesaleException { 
return lookupDnsHosting ( 
pCustomerAccountld, 
pCustomer Password, 
new Properties () , . 
0); 

} 

/** 

* Retrieves a list of all domain names associated with 

* DNS Hosting products owned by customer. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
DomainNamel: 
DomainName2 : . 
DomainName3: 
. . . etc ... 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomer Pas sword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale. toolkit .javaapi. NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DNS_HOSTING 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DNS_HOSTING 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
■ * 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETXrRNED 

* • - - 

V 

public WSPResponse lookupDnsHosting ( 

String pCustomerAccountld, ^ 
String pCustomer Pas sword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return lookupDnsHosting ( 

pCustomerAccountld, 

pCustomerPassword, 

optionalAttributes, 

0); 

} 
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protected WSPResponse lookupDnsHosting ( 
String pCustomer Account Id, 
String pCu s tome r Pas sword. 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + ".lookupDnsHosting (String, String, 
Properties, int) "; . 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs , optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs . put ( PARM_CUSTOMER_PAS SWORD , 
pCustomer Pas sword) ; 

returnCode = conn. make Request (COMBO_LOOKUP_DNS_HOSTING, 

allParmsAndAttrs) ; 

. pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err Sprint In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return lookupDnsHosting ( 
pCustomerAccountld, 
pCustomerPassword, 
optionalAttributes, 
count + 1) ; 

} 

* } 
} 

/** 

* Retrieves details of a specific 

* DNS Hosting product owned by customer. 

* Used, to verify a domain name is part of a DNS Hosting Product 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND EXECUTION SUCCEEDED PROPERTIES BEING RETURNED 
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Expected Result Property Key.(s) Returned: 
ATTR_DOMAIN_NAME 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPas sword the parameter value 

* ©param pDomainName the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit .javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DNS_HOSTTNG 

* ©see NSIWholesaleAPI#COMBO_LOOKUPJDNS_HOSTING 

* ©see NSIWholesaleAPI#PARM_CUSTOMERJVCCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see NS I Who lesaleAPI# PARM_DOMAIN_NAME 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see 

WSPResponse#C0M^4AND_EXECUTION_SUCCEEDED_PR0PERTIES_BEING_RETURNED 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 
* 

*/ 

public WSPResponse lookupDnsHosting ( 
String pCustomerAccountld, 
String pCustomerPas sword, 
String pDomainName) 
throws NSIWholesaleException { 
return lookupDnsHosting ( 

pCustomerAccountld, 

pCustomer Password, 

pDomainName, 

new Properties 0 , 

0); 

} 

/** 

* Retrieves details of a specific 

* DNS Hosting product owned by customer. 

* Used to verify a domain name is part of a DNS Hosting Product 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 
ATTR_DOMAIN_NAME 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPas sword the parameter value 

* ©param pDomainName the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit ... javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_DNS_HOSTING 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_DNS_HOSTING 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
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* ©see NSIWholesaleAPI#PARM_DOMAIN_NAME 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENI ED 

* ©see WSPResponse#OBJECT_NOT_FOUND 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING RETURNED 

. * ©see WSPResponseftCOMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 

*/ 

public WSPResponse lookupDnsHosting { 
String pCustomerAccountld, 
String pCustomerPassword, , 
String pDomainName, 
Properties optionalAttributes) 
throws NSIWholesaleException { 
return lookupDnsHosting ( • 

pCustomerAccountld, 

pCustomerPassword, 

pDomainName, 

optionalAttributes, 

0); 

} 

protected WSPResponse lookupDnsHosting ( 
String pCustomerAccountld, 
String pCustomerPassword, 
String pDomainName, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + lookupDnsHosting (String, String, 
String, Properties, int) " ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command") ; 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool .checkout () ; 
Properties allParmsAndAttrs « new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs . put (PARM_CUSTOMER_ACCOUNT_lD, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_PAS SWORD, 
pCustomerPassword); 

allParmsAndAttrs .put (PARM_DOMAIN_NAME, pDomainName) ; 

returnCode = conn, make Request (COMBO_LOOKUP_DNS_HOSTING, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 
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pool. release (conn) ; 

} 

catch (ResourceException re) { 

System. err .println(methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return lookupDnsHosting ( 
pCus tomerAccount Id , 
pCustomer Pas sword, 
pDomainName, 
opt ionalAt tributes , 
count + 1) ; 

} 



* Retrieves a list of all individual accounts linked to a wholesaler 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES__BEING_RETURNED 
Expected Result Property Key(s) Returned: 

CustomerAccountldl : 

CustomerAccountId2 : 

Cus tomerAccount Id3 : 

. . .etc. 

* </PRExBR> 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi . wholesale . toolkit .javaapi ? NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL__ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_INDIVIDUAL_ACCOUNT 
* 

* ©see WSPResponse#COMMAND_EXECOTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse lookupIndividualAccount ( ) 
throws NSIWholesaleException { 

return lookupIndividualAccount ( 

new Properties () , 

0); 

■ ) 

/** 

* Retrieves a list of all individual accounts linked to a wholesaler 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECuTION_SUCCEEDED_PROPERTI ES_BE ING_RETURNED 
Expected Result Property Key(s) Returned: 
. CustomerAccountldl: 
Cus tomerAccount Id2 : 
Cus tomerAccount Id3 : 
...etc... 
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* </PRExBR> 

+ ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi.wholesale. toolkit, javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMANDJX)0KUP 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_INDIVIDUAL_ACCOUNT 
* 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA__BEING_RETURNED 

* ©see 

WSPResponse#COMKAND_EXECUTION_SUCCEEDED__PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse lookup Individual Account ( 

Properties optionalAttributes) 
throws NSIWholesaleException { 

return lookupIndividualAccount ( 
optionalAttributes, 
0) ; 

} 

protected WSPResponse lookupIndividualAccount ( 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + 
" .lookupIndividualAccount (Properties, int) "; 
if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs . = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
returnCode = 

conn.makeRequest (C0MBO_L0OKUP_INDIVIDUAL_ACCOUNT, allParmsAndAttrs) ; 
pool. checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} . 

catch (ResourceException re) { 

System, err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return lookupIndividualAccount ( 
optionalAttributes, 
count + 1) ; 
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} 



/** 

* Retrieves details of a specific individual customer account. 

* <BRxPRE> 

Expected Major Result Code: 
C0MMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected. Result Property Key(s) Returned: 

ATTR_FIRST_NAME 

ATTR_LAST_NAME 

ATTR~PHONE 

ATTR_AUTH_QUESTION 

ATTR~AUTH_ANSWER 

ATTR_FAX ~ 

ATTR — EMAIL 

ATTR — ADDRESS 1 

ATTR_ADDRESS2 

ATTR_ADDRESS3 

ATTR_ADDRESS4 

ATTR_ADDRESS5 

ATTR_CITY 

ATTR_STATE 

ATTR_POSTAL_CODE 

ATTR_COUNTRY_CODE 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPassword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi.NSIWholesaleExcept ion when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL__ACCOUNT 

* ©see NSIWholesaleAPI#C0MB0_L0OKUP_INDIVIDUAL_ACC0UNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT__ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* • 

* ©see WS PRes pons e#GENERAL_ACCESS — DENIED 

* ©see 

WSPResponse#COMI^D_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse lookupIndividualAccount ( 
String pCustomerAccountld, 
String pCustomerPassword) 
throws NSIWholesaleException { 

return lookupIndividualAccount ( 
pCustomerAccountld, 
pCustomerPassword, 
new Properties () , 
0); 

J 

* Retrieves details of a specific individual customer account. 

* <BR><PRE> 
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Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

ATTR_FI RST_NAME 

ATTR_LAST_NAME 

ATTR_PHONE 

ATTR_AUTH_QUESTION 

ATTR~AUTH_ANSWER 

ATTR_FAX ~ 

attr_email 

attr~addressi 

attr_address2 

attr_address3 

attr_addres s4 

attr_address5 

attr_city 

ATTR_STATE 

ATTR_POSTAL_CODE 

ATTR_COUNTRY_CODE 

* </PRExBR> 

* ©param pCustomer Account Id the parameter value 

* ©param pCustomer Pas sword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale. toolkit. javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_INDIVIDUAL_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMERJPASSWORD 
* 

* ©see WSPResponse#GENERAL_ACCESS^DENIED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 
*/ 

public WSPResponse lookup IndividualAccount ( 
String pCustomerAccountld, 
String pCustomerPassword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return lookup IndividualAccount ( 

pCustomerAccountld, 

pCustomer Pas sword, 

optionalAttributes, 

0); 

} 

protected WSPResponse lookupIndividualAccount ( 

String pCustomerAccountld, 

String pCustomer Pas sword, 

Properties optionalAttributes, 

int count) 
throws NSIWholesaleException { 

String methodName = className + lookupIndividualAccount (String, 
String, Properties, int) " ; 

if (count > retry) { 
i 
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throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_PASSWORD, 
pCustomerPassword) ; 

returnCode = 

conn. makeRequest (COMBOJjOOKUP_INDIVIDUAL_ACCOUNT, allParmsAndAttrs) ; 
pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool. release ( conn) ; 

} 

catch (ResourceException re) { 

System, err. print In (methodName + "Caught 
ResourceException" + re) ; 

) 

finally { 

return lookupIndividualAccount ( 
pCustomerAccountld, 
pCustomerPassword, 
optionalAttributes , 
count + 1) ; 

} 

} 

} 



/** 

* Retrieves a list of all business customer accounts linked to 
wholesaler. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

CustomerAccountldl : 

Cus tomer Account Id2 : 

CustomerAccountId3 : 

. . .etc. . . 

* </PRExBR> 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 
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* ©see NSIWholesaleAPI#COMMAND_LOOKUP 
♦.©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_BUSINESS_ACCOUNT 
* 

* ©see WSPRespon9e#C0MMAND_EXECUTI0N_SUCCEEDED_N0_DATA_BEING_RETURNED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse lookupBusinessAccount ( ) 
throws NSIWholesaleException { 

return lookupBusinessAccount ( 

new Properties () , 

0); 

} 

/•* 

* Retrieves a list of all business customer accounts linked to 
wholesaler. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PR0PERTIES_BEING__RETURNED 
Expected Result Property Key(s) Returned: 

Cus t otner Account I dl : 

Cus t omer Account I d2 : 

CustomerAccountId3 : 

. . .etc. . . 

* </PRExBR> 

* ©param opt ionalAt tributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#C0MBO_L00KUP_BUSINESS_ACCOUNT 
* 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_NO_DATA_BEING_RETURNED 

* ©see. 

WSPResponse#COMMAND_EXECUTION - SUCCEEDED_PROPERTIES_BEING_RETURNED 

.* 

*/ 

public WSPResponse lookupBusinessAccount ( 

Properties optionalAttributes) 
throws NSIWholesaleException { 

return lookupBusinessAccount ( 
optionalAttributes, 
0); 

} 

protected WSPResponse lookupBusinessAccount ( 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName ■ className + 
" . lookupBusinessAccount (Properties, int) " ,• 
if (count > retry) { 

throw new NSI Whole sale Except ion (methodName + "Unable to 
complete command"); 

} 
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NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn a (NSIWholesaleConnection) pool . checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat {allParmsAndAttrs, optionalAttributes) ; 
returnCode m conn.makeReguest (COMBO_LO0KUP_BUSINESS_ACCOUNT, 

allParmsAndAttrs) ; 

pool . checkln { conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err .println(methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return lookupBusiness Ac count ( 
optionalAttributes, 
count + 1) ; 

} 

} 

} 



* Retrieves details. of a specific business customer account. 

* <BRxPRE> 

Expected Major Result Code: . 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

ATTR_COMPANY_NAME 

ATTR_COMPANYJTYPE 

ATTR_EMAIL 

ATTR~PHONE 

ATTR_FAX 

ATTR_ADDRESS1 

ATTR_ADDRESS2 

ATTR_ADDRESS3 

ATTR~ADDRESS4 

ATTR_ADDRESS5 

ATTR_CITY 

ATTRJSTATE 

ATTR_POSTAL_CODE 

ATTR_COUNTRY_CODE 

ATTR_LEGAL_CONTACT_FI RST_NAME 
. ATTR_LEGAL_CONTACT_LAST_NAME 

ATTR_LEGAL_CONTACT_PHONE 

ATTRJLEGAL_CONTACT_FAX 

ATTR~LEGAL_CONTACT_EMAIL 

ATTR~LEGAL_CONTACT_C I T Y 
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ATTR_LEGAL_CONTACT_STATE 
ATTR_LEGAL_CONTACT_POSTAL_COD E 
ATTR_LEGAL_CONTACT_COUNTRY_CODE 
ATTR_LEGAL_CONTACT~ADDRESSl 
ATTR_LEGAL_CONTACT_ADDRES S 2 
ATTRJLEGAL_CONTACT_ADDRESS3 
ATTR_LEGAL_CONTACT_ADDRESS4 
ATTR_LEGAL_CONTACT_ADDRESS5 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomer Pas sword the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command. 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 
* 

* ©see WSPResponse#GENERAL_ACCESS_DENIED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

public WSPResponse lookupBusinessAccount ( 
String pCustomerAccountld, 
String pCustomer Pas sword) 
throws NSIWholesaleException { 

return lookupBusinessAccount ( 
pCustomerAccountld, 
pCustomerPassword, 
new Properties ( ) , 
0); 

} 

/** 

* Retrieves details of a specific business customer account. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

ATTR_COMPANY_NAME 

ATTR_COMPANY_TYPE 

ATTR_EMAIL . 

ATTR_PHONE 

ATTR_FAX 

ATTR~ADDRESS1 

ATTRJVDDRESS2 

ATTR~ADDRESS3 

ATTR_ADDRESS4 

ATTR_ADDRE S S 5 

ATTR_CITY 

ATTR_STATE 

ATTR_POSTAL_CODE 

ATTR_COUNTRY_CODE 

ATTRJJEGAL_CONTACT_FIRST_NAME 

ATTR_LEGAL CONTACT LAST_NAME 
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ATTR_LEGAL_CONTACT_PHONE 

ATTR_LEGAL_CONTACT_FAX 

ATTR_LEGAL_CONTACT_EMAI L 

ATTR_LEGAL_CONTACT_CITY 

ATTR_LEGAL_CONTACT_STATE 

ATTRJ^EGAL_CONTACT_POSTAL_CODE 

ATTR_LEGAL_CONTACT_COUNTRY_CODE 

ATTR_LEGAL_CONTACT_ADDRESSl 

ATTR_LEGAL_CONTACT_ADDRESS2 

ATTR_LEGAL__CONTACT_ADDRESS3 

ATTR_LEGAL_CONTACT_ADDRESS4 

ATTR_L EGAL_CONTACT_ADD R E S S 5 

* </PRExBR> 

* ©param pCustomerAccountld the parameter value 

* ©param pCustomerPas sword the parameter value 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale, toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#COMBO__LOOKUP_BUSINESS_ACCOUNT 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_ACCOUNT_ID 

* ©see NSIWholesaleAPI#PARM_CUSTOMER_PASSWORD 

* ©see . WSPResponse#GENERAL_ACCESS_DENIED 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ . • 

public WSPResponse lookupBusinessAccount ( 
String pCustomerAccountld/ 
String pCustomerPassword, 
Properties optionalAttributes) 
throws NSIWholesaleException { 

return lookupBusinessAccount ( 
pCustomerAccountld, 
pCustomerPassword, 
optionalAttributes, 
0); 

} 

protected WSPResponse lookupBusinessAccount { 
String pCustomerAccountld, 
String pCustomerPassword, 
Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String me thodName » className + " lookupBusinessAccount (String, 
String, Properties, int) 11 ; 

if (count > retry) { 

throw new NSIWholesaleException (me thodName + "Unable to 
complete command") ; 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 
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conn - (NSIWholesaleConnection) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, opt ionalAt tributes) ; 

allParmsAndAttrs .put (PARM_CUSTOMER_ACCOUNT_ID, 
pCustomerAccountld) ; 

allParmsAndAttrs . put <PARM_OJSTOMER_PAS SWORD, 
pCustomer Password) ; 

returnCode = conn, make Request (COMBO_LOOKUP_BUSINESS_ACCOUNT, 

allParmsAndAttrs); 

pool. checkln( conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

. . return lookupBusiness Ac count ( 

pCustomerAccountld, 
pCustomerPassword, 
opt ionalAttributes , 
count + 1) ; 

} 

} 

} 

/ * * 

* Retrieves details of a specif ic technical contact. 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

ATTR_ORGANI ZATION 

ATTR~PHONE 

ATTR_FAX 

ATTR_EMAIL 

ATTR_ADDRESS1 

ATTR_CITY 

ATTR_STATE 

ATTR_POSTAL_CODE 

ATTR_COUNTRY_CODE 

* </PRExBR> 

* ©param pTechContactld the parameter value 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi. wholesale. toolkit .javaapi .NSIWholesaleExcept ion when 
unable to complete command 

. * ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASS_TECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#COMBO LOOKUP TECHNICAL CONTACT 
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* ©see NSIWholesaleAPI#PARMJTECHj:ONTACT_ID 

* "~ • 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
* 

*/ 

public WSPResponse lookupTechnicalContact ( 

String pTechContactld) 
throws NSIWholesaleException { 

return lookupTechnicalContact ( 
pTechContactld, 
new Properties () , 
0); 

} 

/** 

* Retrieves details of a specific technical contact. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 
Expected Result Property Key(s) Returned: 

ATTR_ORGANI ZATION 

ATTR_PHONE 

ATTR_FAX 

ATTR_EMAIL 

ATTR_ADDRESS1 

ATTR_CITY 

ATTR_STATE 

ATTR_POSTAL_CODE , 

ATTR_COUNTRY_CODE 

* </PRExBR> 

* ©param pTechContactld the parameter value 

* ©param optionalAt tributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . j avaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_LOOKUP 

* ©see NSIWholesaleAPI#CLASSJTECHNICAL_CONTACT 

* ©see NSIWholesaleAPI#COMBO_LOOKUP_TECHNICAL__CONTACT 

* ©see NSIWholesaleAPI#PARM_TECH_CONTACT_ID 
* 

* ©see 

WSPResponse#COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED 

■ * 

*/ 

public WSPResponse lookupTechnicalContact ( 
String pTechContactld, 
Properties optionalAt tributes) 
throws NSIWholesaleException { 

return lookupTechnicalContact ( 
pTechContactld, 
opt ionalAttributes , 
0); 

} 

protected WSPResponse lookupTechnicalContact ( 
String pTechContactld, 
Properties optionalAttributes, 
int count) 
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throws NSIWholesaleException { 

String methodName = className + n . lookupTechnicalContact (String, 
Properties, int) M ; 

if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs ■ new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
allParmsAndAttrs. put (PARMJTECH_CONTACT_ID, pTechContactld) ; 
returnCode = 

conn . makeRequest (COMBO_LOOKUPJTECHNICAL_CONTACT, allParmsAndAttrs ) ; 
pool .checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err .print In (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return lookupTechnicalContact ( 
pTechCont act Id , 
optionalAttributes , 
count + 1) ; 

} 

} 

} 

/** . 

* This method returns basic information about the supported 

* protocol commands and classes. 

* <BR><PRE> 

Expected Major Result Code: 
COMMAND_EX ECUT I ON_SUCCEEDED__TEXT_BE I NG_RETURNED 
Expected Text Returned: 

. . .The Help Text. 
Expected Result Property Key(s) Returned: 

textl: 

text2 : 

text3: 

... etc • • • 

* </PRExBR> 

* ©return the Wholesale Server Protocol Server response 
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* ©exception nsi. wholesale. toolkit . javaapi .NSIWholesaleExcept ion when 
unable to complete command 

* ©see WSPResponsetfgetProperties 

* ©see NSIWholesaleAPI#COMMAND_HELP . 
* 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED__TEXT_BEING_RETURNED 
* 

*/ 

public WSPResponse helpO 
throws NSIWholesaleException { 
return help( 

new Properties () , 

0); 

} 

/** " 

* This method returns basic information about the supported 

* protocol commands and classes .. . 

* <BRxPRE> 

Expected Major Result Code: 
COMMAND - EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 
Expected Text Returned: 

. . .The Help Text. 
Expected Result Property Key(s) Returned: 

textl: 

text2 : 

text 3 : 

. . .etc. 

* </PRExBR> 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale. toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see WSPResponse#getProperties 

* ©see NSIWholesaleAPI#COMMAND_HELP 
* 

* ©see WSPResponse#COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 

* ..... 

*/ 

public WSPResponse help( 

Properties optionalAttributes) 
throws NSIWholesaleException { 
return help { 

optionalAttributes , 
0); 

} 

protected WSPResponse help( 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + ". help (Properties, int) 
if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command") ; 

) 

NSIWholesaleConnection conn = null; 
WSPResponse returnCode; 
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try { 

conn = (NSIWholesaleConnect ion) pool. checkout () ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
returnCode = conn . makeRequest (COMMAND_HELP , 

allParmsAndAttrs) ; 

pool. checkln( conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. pr int In (methodName + "Caught 
ResourceException" + re) / 
} 

finally { 

return help( 

optionalAttributes, 
count + 1) ; 

} 

) 

} 

/** 

* This method terminates the wholesaler's access to session commands. 

* <BR><PRE> 

Expected Major Result Code: COMMAND_SUCCEEDED_CLOSING_CONNECTION 

* </PRExBR> 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_QUlT 
• * 

' * ©see WSPResponse#COMMAND_SUCCEEDED_CLOSING_CONNECTION 
* 

V 

public WSPResponse quitO 
throws NSIWholesaleException { 
return quit ( 

new Properties () , 

0); 

} 

/** 

* This method terminates the wholesaler's access to session commands. 

* <BRxPRE> 

Expected Major Result Code: COMMAND_SUCCEEDED_CLOSING_CONNECTION 

* </PRExBR> 

* ©param optionalAttributes a property list of optional attributes 

* ©return the Wholesale Server Protocol Server response 

* ©exception nsi .wholesale . toolkit . javaapi .NSIWholesaleException when 
unable to complete command 

* ©see NSIWholesaleAPI#COMMAND_QUIT 
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* 

* ©see WSPResponse#COMMAND_SUCCEEDED_CLOSING_CONNECTION 
*/ 

public WSPResponse quit ( 

Properties optionalAttributes) 
throws NSIWholesaleException { 
return quit ( 

optionalAttributes, 
0); 

■ } 

protected WSPResponse quit( 

Properties optionalAttributes, 
int count) 
throws NSIWholesaleException { 

String methodName = className + ". quit (Properties, int) "; 
if (count > retry) { 

throw new NSIWholesaleException (methodName + "Unable to 
complete command"); 

} 

NSIWholesaleConnection conn = null; . 
WSPResponse returnCode; 

try { 

conn = (NSIWholesaleConnection) pool . checkout ( ) ; 
Properties allParmsAndAttrs = new Properties () ; 

// put optional attributes 

propertiesCat (allParmsAndAttrs, optionalAttributes) ; 
returnCode = conn.makeRequest (COMMAND_QUIT, 

allParmsAndAttrs) ; 

pool . checkln (conn) ; 
return returnCode; 
} catch (Exception e) { 
try { 

pool . release (conn) ; 

} 

catch (ResourceException re) { 

System. err. println (methodName + "Caught 
ResourceException" + re) ; 

} 

finally { 

return quit ( 

optionalAttributes, 
count + 1) ; 

) 



//#--END API 



* This method shutsdown the Wholesaler Services Protocol API. 

* ©return void 
* 

*/ • 
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public void shutdown () { 

System. out .println ( "NSIWholesaleAPI . shutdown: " + 

"Calling pool . shutdown ( ) ..."); 
//pool . shutdown ( ) ; 
try { 

//pool . close () ; 

pool .Close (60000, 60000) ; 

} 

catch (ResourceException re) { 

System. err .println ("Exception Caught: " + re); 

) 

System. out. print In ("NSIWholesaleAPI .shutdown: " + 
"pool . shutdown ( ) returned ! " ) ; 

} 

// Support Functions 
/** 

* This method parses the string argument as a signed decimal integer 

* ©param valueString the string to be parsed as an int 

* ©return an int representing the valueString 

* ©see java. lang. Integerflparselnt 
* 

*/ 

protected static int parselnt (String valueString) { 
try { 

return Integer .parselnt (valueString) ; 
} catch (Number Format Except ion nfe) { 
return 0; 

} 

/** 

* This method concatinates the source property list onto the end of the 

* target propery list. Filtering is done to remove properties 
associated with 

* credit card charges . 

* ©param target the target (destination) property list 

* ©param source the source property list 

* ©return void 

* ©see java. util. Properties 
* 

*/ 

protected static void propertiesCat (Properties target, Properties 
source) { 

String methodName » className + " .propertiesCat (Properties , 
Properties) "; 

if ((target == null) || (source == null)) { 
return; 

} 

// concatinate source properties onto target properties 
if (source. isEmptyO == false) { 
try { 

String key; 
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String value; 

Enumeration e = source. propertyNames () ; 
while (e.hasMoreElements () ) { 

key a (String) e.nextElement () ; 

value » source. getProperty (key ) ; 
target .put (key, value); 

} . 

} 

catch (NoSuchElementException nsee) { 
System, err. print In (methodName + 

"Invalid Properties"); 
nsee . pr intStackTrace ( ) ; 

} 

} 

return; 

} . 

/** 

* This method concatinates the source property list onto the end of the 

* target propery list. 

* ©param protocol client (your) protocol 

* ©return true if your protocol matches wholesale services protocol, 

* otherwise false 

* ©see NSIWholesaleAPI#ATTR_PROTOCOL 

* ©see NSIWholesaleAPI#Describe 
* 

*/ 

protected boolean verifyConnectionProtocol (String protocol) 
throws NSIWholesaleException { 

String methodName = className + " .verifyConnectionProtocol (String) 

ii . 

WSPResponse wspResponse = describe (ATTR_PROTOCOL) ; 
if (wspResponse == null) { • 

System. err. println (methodName + "Unable to verify connection 
protocol " + protocol) ; 

return false; 

} 

if ( wspResponse. getMa j orResul tCode () == 
WSPResponse . COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED) { 

String wspProtocol = wspResponse . getProperty (ATTR_PROTOCOL) ; 
if (wspProtocol == null) { 

System, err .println (methodName + "Unable to verify 
connection protocol " + protocol) ; 

return false; 

} 

if (protocol .equals (wspProtocol) ) { 

System. out .println (methodName + "Successfully verified 
connection protocol " + protocol) ; 

return true; 

} 

else { 

System, err .println (methodName + "Failed to verify 

connection protocol: " + 

"Your Protocol = <" + protocol + "> while 
Wholesale Services Protocol » < u + wspProtocol + ">"); 

return false; 
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} 

} 

else { 

System. err. println (me thodName + "Unable to verify connection 
protocol " + protocol) ; 

return false; 

. 1 

} 

// - - 

// End of file NSIWholesaleAPI . java 

// - Copyright (c) 2000 Network Solutions, Inc 



The class definition for WSPResponse is as follows: 

//----- — - 

// Package 

// _ 

package nsi .wholesale . toolkit . javaapi ,- 

//- — - - 

// Imports. . . 

//- 

import java .util .NoSuchElement Exception; 

import java.util.StringTokenizer; 

import java.util.Hashtable; 

import java. util. Vector ; 

import java. util. Enumeration; 

import j ava. util . Properties; 

import j ava. text.*; 

/** 

* . Copyright (c) 2000 Network Solutions, Inc <BR> 

* This class represents the various components of a 

* Wholesale Services Protocol (WSP) Response. 

* A WSP response will be returned for each request that is issued 

* throught the protocol. A response will describe, in as much detail 

* as possible, the outcome of the issued request, and will optionally 

* include any additional information that was generated by the request. 

* A result consists of a 'result code' followed by a descriptive 

* 'result message'. A 'result code 1 consists of a major result code 

* followed by a period ('.'), followed by a minor result code. 

* The three-digit major result code provides a general indication of 

* the success or failure of an issued request. 

* In most cases, one or more result properties are returned. A result 

* property consists of a property key followed by a colon {":•), 

* followed by a property value. 

* In other cases, plain text is returned (e.g. the information returned 

* from the Help command) w Both of these cases are indicated by specific 

* result codes. 
* 

* ©author David A. Moston 

* ©see NSIWholesaleAPI 
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* ©since 27 July 2000 

* ©version 1.0 
* 

* 

*<BR> - - - <BR> 

* $Log$ 

*<BR> --<BR> 

*/ 

public class WSPResponse { 



// - - - - ----- 

// Beginning of Required/Standard Fields 

// - - 

/** Serial Version */ 
15 static long serialVersion = 1L; 

/** Release Version */ 
static double version s 1.0O; 

20 /** SCCS control ID */ 

static final String sccsID = "©(#) wholesale- sdk_dl . 12. 1.3 08/04/00 
10:27:15 WSPResponse . j ava NSI"; 

/** JDK Version */ 
25 static String jdkVersion 1.1.7" ; " 

// Static Accessor Method (s) . . . 

/** Static accessor method to get serial version */ 
static public long getSerialVersion ( } { return serialVersion; } 

/** Static accessor method to get release version */ 
static public double getVersionO { return version; } 



/** Static accessor method to get JDK version */ 
35 static public String get JdkVersion () { return jdkVersion; } 

// ----- 

// End of Required/Standard Fields 

//--- - ------ ... 

40 // - — 

// class (static) variable (s) ... 

//.. ..... . ..... 

/** The name of this class */ 

private static final String className = "WSPResponse"; 

45 

/** Ease -of -use constant for Major Result Code: Minimum. 
(Note: this is NOT a valid/ supported major result code) 
All valid/ supported major result codes will be 

greater than the minimum and less than the maximum, respectively */ 
50 public static final int MA J OR_RESULT_C0DE_M I N = 99; 

/** Ease-of-use constant for Major Result Code [General Information]: 
Minimum. 

(Note: this is NOT a valid/ supported major result code) */ 
55 public static final int MAJOR_RESULT_C0DE_GENERAL_INF0RMATION_MIN = 99; 

/** Ease-of-use constant for Major Result Code [General Information] : 
General information */ 
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public static final int GENERAL_INFORMATION = 100; 

/** Ease-of-use constant for Major Result Code [General Information]: 
Maximum . 

(Note: this is NOT a valid/ supported major result code) */ 
public static final int MA J OR_RES ULT_CODE_GENERAL_ I NFORMAT 1 0N_MAX = 199 ; 



: Minimum. 
*/ 

199; 

: Authentication 



/** Ease-of-use constant for Major Result Code [Success] 
(Note: this is NOT a valid/supported major result code) 
public static final int MAJOR_RESULT_CODE_SUCCESS_MIN = 
/** Ease-of-use constant for Major Result Code [Success] 
successful */ 

public static final int AUTHENTICATION_SUCCESSFUL = 210; 

/** Ease-of-use constant for Major Result Code [Success] : Session created 

*/ 

public static final int SESSION_CREATED '« 220; 

/** Ease-of-use cpnstant for Major Result Code [Success] : Command 
succeeded, closing connection */ 

public static final int COMMANDOS UCCEEDED_CLOS I NG_CONNECT I ON = 221; 
. /** Ease-of-use constant for Major Result Code [Success] : Command 
accepted, now executing * / 

public static final int C0MMAND_ACCEPTED_N0WJ3XECUTING = 230; 

/** Ease-of-use constant for .Major Result Code [Success] : Command not 
available */ 

public static final int COMMAND_NOT_AVAILABLE = 231; 
/** Ease-of-use constant for Major Result Code [Success] : Command 
execution succeeded, no data being returned; Ok */ 

public static final int 
COMMAND_EXECUTION_SUCCEEDED_NO_DATA__BEING_RETURNED = 24 0; 

/** Ease-of-use constant for Major Result Code [Success] : Command 
execution succeeded, properties being returned */ 

public static final int 
COMMAND_EXECUTION_SUCCEEDED_PROPERTIES_BEING_RETURNED = 241; 

/** Ease-of-use constant for Major Result Code [Success] : Command 
execution succeeded, text being returned */ 

public Static final int COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 



242 j 



/** Ease-of-use constant for Major Result Code [Success] : Maximum. 
(Note: this is NOT a valid/ supported major result code) */ 
public static final int MAJOR_RESuXT_CODE_SUCCESS_MAX = 299; 



Minimum. 
*/ 

299; 
Authentication 



Too many 



/** Ease-of-use constant for Major Result Code [Failure] 
(Note: this, is NOT a valid/ supported major result code) 
public static final int MAJORJ*ESULT_CODE_FAILURE_MIN = 
/** Ease-of-use constant for Major Result Code [Failure] 
failed */ 

public static final int AUTHENT I CAT ION^FA I LED « 310; 

/** Ease-of-use constant for Major Result Code [Failure] 
connections */ 

public static final int T00_MANY_C0NNECTI0NS = 320; 

/** Ease-of-use constant for Major Result Code [Failure] 
connections from current wholesaler */ 

public static final int T0O_MANY_CONNECTI0NS_FR0M_CURRENT_WH0LESALER = 

321; 

/** Ease-of-use constant for Major Result Code [Failure] : Wholesaler 
account has been suspened */. 

public static final int WHOLE SALE R_ACCOUNT_HAS_B E EN__SUS PENDED = 322; 



Too many 
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/** Ease-of-use constant for Major Result Code [Failure] : Session timed 

out */ 

public static final int SESSION_TIMED_OUT = 323; 

/** Ease-of-use constant for Major Result Code [Failure] : Server closing 
connection - Command timed out */ 

public static final int SERVER_CLOSING_CONNECTION = 324; 

/** Ease-of-use constant for Major Result Code [Failure] : Invalid command 

*/ 

public static final int INVALID_COMMAND = 330; 

/** Ease-of-use constant for Major Result Code [Failure] : Invalid class 

*/ 

public static final int INVALID_CLASS m 331; 

/** Ease-of-use constant for Major Result Code [Failure] : Formatting 
error */ 

public static final int FORMATTING_ERROR » 332; 

/** Ease-of-use constant for Major Result Code [Failure] : Missing 
required parameter */ 

public Static final int MISSING_REQUIRED_PARAMETER - 333; 

/** Ease-of-use constant for Major Result Code [Failure] : Invalid 
attribute */ 

. public static final int INVALID_ATTRIBUTE = 334; 

/** Ease-of-use constant for Major Result Code [Failure] : Invalid value 

*/ 

public static final int I NVAL I D_VALUE = 335; 

/** Ease-of-use constant for Major Result Code [Failure] : Missing 
required attribute */ 

public static final int MISSING_REQUIRED_ATTRIBUTE = 336; 

/** Ease-of-use constant for Major Result Code [Failure] : Missing 
required value */ 

public static final int MISSING_REQUIRED_VALUE = 337; 

/** Ease-of-use constant for Major Result Code [Failure] : Missing 
parameter */ 

public static final, int I NVALID — PARAMETER ■ 338; 

/** Ease-of-use constant for Major Result Code [Failure] : Command failed, 
unknown error - Command failed, internal error */ 

public static final int COMMAND_FAILED_UNKNOWN_ERROR = 340; 

/** Ease-of-use constant for Major Result Code [Failure] : Object not 
found */ 

public static final int OBJECT_NOT_FOUND ■ 341; 

/** Ease-of-use constant for Major Result Code [Failure] : Command access 
denied */ 

public static final int COMMAND_ACCESS_DENIED = 342; 

/** Ease-of-use constant for Major Result Code [Failure] : General access 
denied - Access to request denied */ 

public static final int GENERAL_ACCESSJDENIED = 343; 
/** Ease-of-use constant for Major Result Code [Failure] : Maximum, 
(Note: this is NOT a valid/ supported major result code) */ 
public static final int MAJOR_RESULT_CODE_FAILURE_MAX = 399; 

/** Ease-of-use constant for Major Result Code: Maximum. . 
(Note: this is NOT a valid/ supported major result code) 
All valid/supported major result codes will be 

greater than the minimum and less than the maximum, respectively */ 
public static final int MAJOR_RESULT_CODE_MAX = 400; 



// 
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class (static) method(s) ... 



static initializer block . . . 



instance Variable (s) ... 



* WSP response result code (consisting of a major result code, 

* followed by a period ('.'), followed by a minor result code) . 

*/ 

private String resultCode « null; 
/** 

* WSP response major result code 
*/ 

private int majprResultCode = 0; 
/** 

* WSP response minor result code 
*/ 

private int minorResultCode = 0; 
/** 

* The original WSP text response' string used to instantiate object. 

* The raw WSP response consists of one or more <CRLF> delimited lines 

* terminated by a line containing only a period <'. ! ), followed by 
<CRLF>. 

*/ 

private String rawResponse = null; 
/* * 

* The result message extracted from the original WSP text response. 
*/ 

private String resultMessage = null; 
I * * 

The WSP response attributes extracted from the original WSP 

text response. 

V 

private Hashtable attributes = null; 



// 

// Constructors 

//.. --_ ---- 

/** 

* Parses a WSP text response and extracts and stores the 
. * various components. 

* ©param data the raw WSP response text 
* 
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* ©exception I nvalidArgument Except ion if <code>data</code> is null. 

* ©exception InvalidResponseFormatException if <code>data</code> is. 

* not a properly formatted 

* WSP response. 
*/ 

public WSPResponse (String data) 

throws InvalidArgumentException, InvalidResponseFormatException { 

if (data =» null) { 

throw new InvalidArgumentException( "null argument: data"); 



parseRawResponse (data) ; 
setRawResponse (data) ; 

} 

/** 

* Create a new WSPResponse based on value inputs. 
* 

* ©param majorCode the major code for the WSPResponse. 

* ©param minorCode the minor code for the WSPResponse. 

* ©param message the text string associated with the message. 

* ©param assocProps the properties associated with this message. 

* 

.* ©exception I nvalidArgument Except ion if majorCode or minorCode is or 

* not in the appropriate range. 
*/ 

public WSPResponse (int majorCode, int minorCode, 

String message, Properties assocProps) 
throws InvalidArgumentException { 

if ( (iriajorCode » null) || (minorCode m null) |j 

(majorCode < MAJOR_RESULT_CODE_MIN ) | | (majorCode > 
MAJOR_RESULT_CODE_MAX ) | | 

(minorCode < 0 ) || (minorCode > 999)) { 

throw new InvalidArgumentException ( "null argument: data"); 

majorResultCode = majorCode; 
minorResultCode = minorCode; 
resultMessage * new String (message) ; 
if (assocProps ! = null) { 

Enumeration enum = assocProps . proper tyNames ( ) ; 
while (enum.hasMoreElements () ) { 

String propjcey = (String) enum.nextElement ( ) ; 
String value = prop. get Property (propjcey) ; 
addAttribute (prop^key, value); 

} 

} 

DecimalFormat myFmt = new DecimalFormat ( ) ; 
myFmt . setMinimumlntegerDigits (3) ; 
myFmt . setMaximumlntegerDigits (3 ) ; 
myFmt . setMaximumFractionDigits (3) ; 
myFmt . setMinimumFractionDigits (3) ; 
double x = majorCode + minorCode/ 1000 . 0 ; 
resultCode = myFmt . format (x) ; 
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} 

// ---- ----- - 

// Accessors and Mutators 

//"- — r ------ 

/** 

* Returns the original WSP text response string used to instantiate 

* object. 

* ■ 

* ©return the original WSP text response. 
*/ 

public String getRawResponse () { 
return rawResponse; 

} 

/** 

* Returns the result message extracted from the original WSP 

* text response . 
* 

* ©return the WSP response result message. 
*/ 

public String getResultMessage 0 { 
return resultMessage; 

} 



/** 

* Returns any attributes, if applicable, extracted from the original 

* WSP text response. 
* 

* ©return response attributes if any exist, null otherwise. 

*/ - 
Hashtable getAttributes () { 
return attributes; 

} 

/** 

* returns the result property value corresponding to the specified 

* result property key, if found, extracted from the original 

* WSP text response. 

* ' , • 

* ©param resultPropertyKey a result property key 

* ©return the corresponding result property value, otherwise null 
*/ 

public String getProperty (String resultPropertyKey) { 
String resultPropertyValue = null; 
Hashtable attributes = getAttributes () ; 

if (attributes == null) { 

return resultPropertyValue; 

} 

Vector vector = (Vector) attributes .get (resultPropertyKey) ; 

if (vector null) { 

return resultPropertyValue; 
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} 

for (int i = 0; i < vector . size () ; i++) { 

resultPropertyValue = (String) vector . elementAt (i) ; 

5 } . 

return resultPropertyValue; 

} 

10 • • /** 

* Returns a property list containing all result property 
specifications, 

* if applicable, extracted from the original WSP text response. 

* Note: when the major result code = 

15 COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 

* text is being returned in the response, as opposed to result property 
specifications . 

* Since there are no defined result property keys for returned text, a 

dummy 

20 * result property key is generated for each line of text. 

* That dummy result property key will look like f text#', where # 
Vis a number from 1 to N (N being the number of lines of text 

returned) . 

* For example, the first dummy result property key will be ' textl 1 . 
25 * For example, the tenth dummy result property key will be 1 textlO 1 . 

* 
* 

* ©return response attributes if any exist, null otherwise. 

* ©see WSPResponsetfgetText 
30 */ 

public Properties getProperties () { 

Properties props = new Properties 0 ; 



35 



Hashtable attributes = getAttributes ( ) ; 

if (attributes == null) { 
return null; 

} 

40 Enumeration enum = attributes . keys () ; 

int lineNumber = 0; 

while (enum.hasMoreElements 0 ) { 

lineNumber++; 
45 String key = null; 

Vector vector = null; ... 

key = (String) enum. next Element () ; 

//if Command execution succeeded; text being returned 
50 if (getMajorResultCodeO mm 

COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED) { 

key = "text" + lineNumber; // Create. a "dummy" key 

for this line of text 

} 

55 vector « (Vector) attributes .get (key) ; 

for (int i=0; i < vector . size (); i++) { 
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props. put (key, (String) vector . elementAt (i) ) ; 

} 

} 

return props; 

} 

/**■ 

* Returns a property list containing all result property 
specifications, 

* if applicable, extracted from the original WSP text response. . 

* Note: when the major result code « 
COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED 

* text is being returned in the response, as opposed to result property 
specifications. 

* Since there are no defined result property keys for returned text, a 

dummy 

* result property key is generated for each line of text. 

* That dummy result property key will look like 'textjp, where # 

* is a number. from 1 to N (N being the number of lines of text 
returned) . 

* For example, the first dummy result property key will be 'textl'. 

* For example, the tenth dummy result property key will be ■ textlO'. 
* 

* ©param wspResponse the WSP response 

* ©return response attributes if any exist, null otherwise. 

* ©see WSPResponsettgetText 
*/ 

public static Properties getProperties (WSPResponse wspResponse) { 
return wspResponse .getProperties () ; 

} 

/** ' 

* returns a vector containing lines of text returned in the WSP 
response. 

* Note: when, the major result code is 
COMMAND_EXECUTION_SUCCEEDED_TEXT_BE ING_RETURNED , 

* text is being returned in the response, as opposed to result property 
specifications. 

* There are no result property keys defined for text. 

* This method returns a vector of Strings. Each element (String) in 
the vector is a line of text. 

* 

* ©param wspResponse the WSP response 
* 

* ©return a vector containing lines of text returned, otherwise null 

* ©see WSPResponsetfget Properties 
V 

public Vector getText () { 

Vector text « new Vector (); 

//if not: Command execution succeeded; text being returned 
if (getMajorResultCodeO ! = 
COMMAND_EXECUTION - SUCCEEDED_TEXT_BEING_RETURNED) { 
return null; 

} 
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Hashtable attributes = getAttributes 0 / 

if (attributes =~ null) { 
return null; 

Enumeration enum = attributes .keys () ; 

int lineNumber = 0; 

while (enum.hasMoreElements () ) { 

lineNumber++; 

String key = null; 

Vector vector = null; 

key = (String) enum.nextElement () ; 

//Command execution succeeded; text being returned 

key = "text" + lineNumber; // Create a "dummy" key f 

this line of text 

vector = (Vector) attributes. get (key) ; 

for (int i=0; i < vector . size () ; i++) { 

text .addElement ( (String) vector. elementAt(i) ) ; 

} 

} 

return text; 

} 



* sets the raw response text 
* 

* ©param aRawResponse the raw WSP response text 

* ©return void 
*/ 

private void setRawResponse (String aRawResponse) { 
rawResponse = aRawResponse; 

} 

* sets the response result code 
* 

* ©param inResultCode the WSP response result, code 

* ©return void 
*/ 

private void setResultCode (String inResultCode) { 
resultCode = inResultCode; 

} 

/** 

* returns the WSP response result code and result message 

* ©return the WSP response result code and result message 
*/ 

public String getResultCodeAndMessage () { 

return (getResultCode ( ) + " " + getResultMessage ( ) ) ; 
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* returns the WSP response result code 
* 

* ©return the WSP response result code 
*/ 

public String getResultCode () { 
return resultCode; 

} 

/**■ 

* returns the WSP response major result code 
* 

* ©return the WSP response major result code 
*/ 

public int getMajorResultCode () { 
parseResultCode () ; 
return majorResultCode; 

} 

* returns the WSP response minor result code 
* 

* ©return the WSP response minor result code 
*/ 

public int getMinorResultCode () { 
parseResultCode () ; 
return minorResultCode; 

} 



f-k-k 

* sets the WSP response result message 
* 

* ©param aResultMessage the WSP response result message 

* ©return void 
*/ 

private void setResultMessage (String aResultMessage) { 
resultMessage = aResultMessage; 

} 



/** 

* sets the WSP response attributes 
* 

* ©param hash the WSP response attributes 

* ©return void 
*/ 

private void setAttributes (Hashtable hash) { 
attributes = hash; 

} 

//---- .-- 

// General Methods 

// — - - 
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* parses the current result code into major and minor result codes. 
* 

* ©return true if result code is successfully parsed, otherwise false 
*/ 

private boolean parseResultCode () { 
boolean rc = true; 

String methodName ■ className + 11 . parseResultCode ( ) 11 ; 

String sResultCode = getResultCode () ; 

String sMajorRe suit Code = null; 

String sMinorResultCode = null; 

int iMajorResultCode = 0; 

int iMinorResultCode = 0; 

try { 

StringTokenizer st = new StringTokenizer (sResultCode, " . "Jj- 
sMajorResultCode = st .nextToken ( ) ; 
sMinorResultCode = st .nextToken () ; 

iMajorResultCode = Integer .parselnt (sMajorResultCode) ; 
iMinorResultCode = Integer .parselnt (sMinorResultCode) ; 

} 

catch (NoSuchElementExcept ion nsee) { 

System. err. print In (methodName + "Unable to parse result code 

+ sResultCode + "> M ); 
nsee . printStackTrace ( ) ; 

} 

catch (NumberFormat Except ion nfe) { 

System. err .print In (methodName + "Invalid result code <" 

+ sResultCode + ">" ); 
nfe .printStackTrace ( ) ; 

} 

finally { 

if (iMajorResultCode <= 0) { 
rc = false; 

} 

else { 

majorResultCode = iMajorResultCode; 
minorRe suit Code = iMinorResultCode; 

} 

} 



} 



return rc; 



/** 

* prints debug-type representation of the WSP Response to standard 

output 

* 

* Oparam response a WSP resonse 

* ©return 'void 

*/ 

public static void displayResponse (WSPResponse response) { 

System. out .println ("Result Code: n + response .getResultCode () ); 
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System.out .println ("Major Result Code: " + 

response . getMa j orResul tCode ( ) ) ; 
System.out .println ("Minor Result Code: " + 

response . getMinorResultCode ( ) ) ; 
System. out .println ( "Result Message: " + 
response . getResultMessage ( ) ) ; 

Hashtable attributes = response .getAt tributes () ; 

if (attributes == null) { 

System.out .println ("Result Properties: NONE"); 
return; 

} 

System. out .println ( "Result Properties:"); 

Enumeration enum = attributes . keys () ; 

while (enum.hasMdreElements 0 ) { 
String key » null; 
Vector vector = null; 

key = (String) enum.nextElement () ; 
vector = (Vector) attributes .get (key) ; 

for (int i=0; i < vector . size () ; i++) { 
. System. out .println(key + " : " + 
(String) vector. elementAt (i) ) ; 

} 

} 

} 

/** 

* returns the raw WSP response 
* 

* ©return a string representing the raw WSP response 
*/ 

public String toString 0 { 

if (rawResponse != null) { 
return rawResponse; 

} 

if (responseCode == null) { 

fabricatedResponse = new String ("001 . 001" ) ; 
} else { 

fabricatedResponse = new String (responseCode) ; 

} 

if (resultMessage «a null) { 

fabricatedResponse = new 
String (fabricatedResponse+"<<Message is null>>\r\n" ) ; 
} else { 

fabricatedResponse = new 
String(fabricatedResponse+resultMessage+"\r\n") ; 

} 

if (attributes != null) { 

Enumeration enum = attributes. keys () ; 
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while (enum.hasMoreElementsO ) { 
String key « null; 
Vector vector ■ null; 

key = (String) enum.nextElement () ; 
vector c (Vector) attributes .get (key) ; 

for (int i=0; i < vector . size () ; i++) { 
fabricatedResponse = new 
String (fabricatedResponse* key + 

n . it + 

(String) vector .eleraentAt (i) + 

"\r\n") ; 

} 

} 

> . 

fabricatedResponse ■ new String (f abricatedResponse+" . \r\n H ) : 
return fabricatedResponse; 

} 

I * * 

* Parse raw WSP text response and extract and store all components 

* ©param data the raw WSP text response 

* ©return void 

* ©exception InvalidRespbnseFormatException upon detection of an 
invalid response format 

*/ 

private void parseRawResponse (String data) 

throws InvalidResponseFormatException { 

String methodName = className + " .parseRawResponse (String) " ; 
// 

// Split data by <CRLF> 
// 

StringTokenizer st = new StringTokenizer (data, "\r\n" ) ; 
// 

// Get the first line of the response 
II 

String responseLine = " " ; 
try { 

responseLine = st .nextToken () ; 



line" ) ; 



} catch (NoSuchElementException e) { 

throw new InvalidResponseFormatException ( "Missing first 



// 

// Extract "result code" and "result message" from first line 
// of response . 
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// 

int spacelndex = responseLine . indexOf ( 1 ' ); 
ft 

II If there is no space in the string, then the format is invalid. 
// First line must be "code message" 

It 

if (spacelndex == -1) { 

throw new InvalidResponseFormatException ( 
"missing/invalid code and message"); 

} * • 

// 

// The code is comprised of the set of characters spanning the 

// the first character to the space 

// 

String myresultCode = responseLine. substring(0, spacelndex); 
// 

// trim any whitespace from both ends of code 
// 

myresultCode = myresultCode . trimO ; 
// 

// Attempt to convert the string result code to an integer 
// 

setResultCode (myresultCode) ; 
// 

// Extract the result message now 
// 

String desc - null; 
// 

//The result message is comprised of all characters spanning from 
// the first character after the space to the end of the entire 

string 

// 

desc = responseLine. substring (spacelndex + 1, 
responseLine . length ()) ; 

// 

// trim any whitespace from both ends of code 
// 

desc = desc. trimO; 

if (desc. length () « 0) { 

throw new InvalidResponseFormatException ( 
"Missing result message"); 

} ... 

setResultMessage (desc) ; 



String key; 
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String value; 

int colonlndex = 0; 

//if Command execution succeeded; text being returned 
if (getMajorResultCode () == 
COMMAND_EXECUTION_SUCCEEDED_TEXT_BEING_RETURNED ) { 

int lineNumber = 0; 

try { 

while (st . hasMoreTokens () ) { 
lineNumber++; 

// 

// Create a "dummy" key for this line of text 
II 

key m "text" + lineNumber; 
// 

// Get the next line from the response 
// 

value » st .nextTokenO ; 



terminator 



// Break from the loop if we hit the response 
// 

if (value. trimO .equals (".") ) { 
break; 

} 

II 

II Save attribute 
// 

//addAt tribute (key. toLowerCase () , value) ; 
addAt tribute (key, value); 

} // end while 

} // end try 

catch (NoSuchElementException e) { 

throw new InvalidResponseFormatException( 

"Error splitting response by ' \r\n»" , e) ; 
} // end catch 



} 

else 

{ 



// 

// Iterate through the rest of the response, searching for 
// attributes. Break from the loop when we encounter the 
// response terminator 
// 

try { 

while ( st . hasMoreTokens ( ) ) { 
// 

// Get the next line from the response 
II 
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10 



15 



20 



25 



30 



we've 
haven 1 1 , 



response terminator 



responseLine = st .nextToken () ; 
II 

II Try to find the colon (': f ) in the string 
// 

colonlndex = responseLine . indexOf (*:»); 
// 

// If the colon is missing, then check to see if 

// encountered the response terminator. If we 

// then the response is formatted improperly 
// 

if (colonlndex -1) { 

responseLine = responseLine. trim() ; 

// 

// Break from the loop if we hit the 
// 

if (responseLine . equals (".")) { 
break ; 



} 

else { 



InvalidResponseFormatException ( 
pair") ; 

} 



throw new 

"Invalid attribute key-value 



35 



40 



45 



50 



colon 



colon 



} 



// 

// The attribute key is everything before the 
II 

key = responseLine. substring (0, colonlndex); 
key = key. trim () ; 

// 

// The attribute value is everything after the 
// 

value = responseLine. substring (colonlndex + 1) ; 
value a value, trim () ; 

// 

// Save attribute 
// 

//addAttribute (key . toLowerCase ( ) , value) ; 
addAttribute (key, value); 

// end while 



55 



} // end try 

catch (NoSuchElementException e) { 

throw new InvalidResponseFormatException ( 
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"Error splitting response by •XrNn'", e) ; 
} // end catch 



} 

} / /parseRawRespose 



} 



/** 

* Attributes are stored in a hashtable. Since there can be multiple 

* values for the same key, we store all values in vectors. Everytime 

* a value is added for a key that already exists, we just add that 

* value to that key's vector. If a key does not yet exist, then 

* we create a new vector and add the value to it. 
* 

* ©param key a result property key 

* ©param value a result property value 

* ©return void 
*/ 

private void addAt tribute (String key, String value) { 
Hashtable hash = getAttributes ( ) ; 

if (hash null) { 

hash = new Hashtable () 
setAttributes (hash) ; 

} 

Vector vector = (Vector) hash. get (key) ; 

if (vector == null) { 

vector = new Vector (1); 
hash. put (key, vector) ; 

} 

vector .addElement (value) ; 



// 

// End of file WSPResponse.java 

// Copyright (c) 2000 Network Solutions, Inc 
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WHAT IS CLAIMED IS: 



1 . A method for interfacing a user application program to a system for conducting a 
transaction associated with managing Internet domain names, comprising the 



steps of: 



receiving a request in an application program interface from the 

application program to establish over the Internet a session 

between the user and the system; 
authenticating the right of the user to conduct a transaction associated with 

managing Internet domain names; 
establishing a secure socket layer within the application program interface 

and the system; 

receiving a request in the application program interface from the 

applications program to initiate a transaction following such 
authentication; and 

transmitting commands from the application program interface, to the 
system effectuating the transaction. 



notifying the application program as to the status of processing of the 
command. 



2. 



A method as set forth in claim 1, further comprising the step of: 
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3. 



A method as set forth in claim 2, wherein: 



the notifying step comprises the step of returning a response to the 



application program containing a statement indicating whether the 



transaction has been fulfilled. 



4. A method as set forth in claim 3, wherein: 

the statement comprises a message which includes an ASCII text portion, 
followed by a delimiter portion. 

5. A method as set forth in claim 4, wherein: 

the ASCII text portion is selected from a predefined dictionary of statements. 

6. A method as set forth in claim 1, wherein: 



authenticating the user is determined from the Internet Protocol address, 



secure socket layer encryption, and user name and password provided by 



the application program. 



7. 



A method as set forth in claim 1, wherein: 



the authenticating step includes the step of at least one additional attempt 
to authenticate the user following a first failed attempt. 
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8. A method as set forth in claim 7, wherein: 

following said at least one additional attempt to authenticate the user is denied 
further attempts to be authenticated should said at least one additional attempt fail. 

9. Apparatus for interfacing a user application program to a system for conducting 
transactions associated with managing Internet Domain Names comprising: 

a component for receiving a request from an applications program to 
establish over the Internet a connection between a user and the 



5 



system; 



a component for authenticating the right of the user to conduct a 



transaction associated with managing Internet domain names; 



a component for establishing a secure socket layer within the apparatus; 



a component for initiating a transaction following such authentication and 



10 



following receipt of a request from the applications program; and 



a component for transmitting commands for effectuating the transaction 



via the secure socket layer to the system. 
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